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Vorwort 


In Ihren Händen halten Sie eines der weinigen Büchern, die nach der 
Commodore-Pleite erschienen sind. Seit Mitte 95 geht es so langsam 
durch die neue Firma Amiga-Technologies (AT) wieder aufwärts. 
Leider läßt die Produktion der Software "noch" etwas zu wünschen 
übrig - was wohl auch bald der Vergangenheit angehören wird. 


Ein großes Problem ist die fehlende Dokumentation der neuen 
Amiga-Modelle (AA-ChipSet). Die meiste Literatur, wenn überhaupt 
vorhanden, handelt in der Regel den Themenbereich recht kurz ab 
und dazu noch in englischer Sprache. 


Mit diesem Buch möchte ich versuchen, diese Lücke zu schließen und 
allen Programmierern ein aktuelles Nachschlagewerk bieten. Der 
Ausdruck "Nachschlagewerk" ist wohl auch nicht ganz zutreffend, 
denn viele Kapitel sind mit ausführlichen Beispielen unterlegt und 
sehr viele Informationen werden Sie wohl wahrscheinlich in keinem 
anderen Buch finden. 


Dem Buch ist eine Diskette beigelegt, die alle in Buch vorhandenen 
Beispiele enthält und zudem noch die aktuelle Version des Game- 
Animators. Durch dieses Programm wird das Erstellen von Hinter- 
gründen und Animationen für Spiele zum Kinderspiel. 


Die Entwicklung des Buches und Game-Animators vollzog sich über 
mehrere Jahre hinweg. Viele Testphasen und Überarbeitungen waren 
notwendig, bis das Projekt in seiner jetzigen Form heranreifte. In 
Bezug darauf möchte ich mich bei Sonja Pasche bedanken, die in 
kürzester Zeit das Buch durchgearbeitet hat. 
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1. Hardwaregrundlagen 


Der Amiga ist ein graphisch orientierter und damit benutzer- 
freundlicher Computer. Er war von Anfang an auf einfache Bedienug 
ausgelegt und nicht wie die Konkurrenz, bei der jede Erweiterung 
über umständliche Eingaben angemeldet werden müssen. Auch wenn 
die ersten Versionen des Amiga-Betriebssystems noch einiges zu 
wünschen übrig ließen, hat sich dieses ab der Version 2.04 
entscheidend geändert. 


Der Amiga besitzt ein echtes 32-Bit-Multitasking-System und das 
schon seit einigen Jahren. Dieses ist mittlerweile in der Version 3.1 so 
ausgereift, daß Programmabstürze äußerst selten sind. Kommt es 
trotzdem zu einem Absturz (Guru...) liegt dieses meistens an der 
Programmierung und nicht an dem Betriebssystem. 


Nicht nur der Benutzer wird durch die graphische Oberfläche in 
seiner Tätigkeit erheblich unterstüzt, sondern auch dem Program- 
mierer steht eine Unzahl von Routinen durch das Betriebssystem zur 
Verfügung, mit denen das Erstellen von Programmen zum Kinderspiel 
wird. Damit wäre das Programmieren der Hardware eigentlich 
überflüssig. Doch leider ist dem nicht so, denn die Geschwindigkeit in 
einigen Bereichen läßt immer noch zu wünschen übrig, auch wenn 
sich das ab der Version 3.1 schon deutlich geändert hat. Der größte 
Teil des System wurde in der Hochsprache C geschrieben und ein C- 
Compiler kann nie so einen effektiven Maschinencode erzeugen, wie 
ein Assembler. 


Richtig schnelle Programme kann man nur in Assembler über die 
Hardware programmieren. Gerade bei Spielen hat man keine andere 
Möglichkeit. Deswegen muß das System nicht brach liegen, was das 
Kapitel 14 durch die LowLevel-Library beweist. Außerdem möchten 
Sie Ihren Amiga bestimmt von Grund auf kennen lernen, sonst hätten 
Sie sich wohl kaum dieses Buch zugelegt. 
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1.1 Amigaaufbau 


Die meisten von Ihnen beherrschen ja weitgehend die Programmier- 
ung des 680x0er Prozessors. Doch nur dessen Befehlssatz zu kennen 
reicht nicht aus, um den Amiga in Maschinensprache programmieren 
zu können. Man muß ebenso den inneren Aufbau des Amiga kennen; 
d. h. seine Co-Prozessoren und deren Registerbelegung. Denn gerade 
diesen Co-Prozessoren, speziell dem Blitter, hat der Amiga seine 
vielfältigen Fähigkeiten zu verdanken. 


Die wichtigsten Bausteine im Amiga sind der Prozessor, zwei Ein- 
/Ausgabe-Bausteine und die Customchips. Damit besteht jeder Amiga 
aus folgenden Bausteinen: 


- 1 680x0-Prozessor von Motorola 
- 2 Ein /Ausgabebausteine (CHA 8520) 
- 3 Customchips (Agnus, Denise, Paula oder Alice, Lisa, Paula) 


Aber was ist ein Computer ohne seine Verbindungen zur Außenwelt? 
Natürlich nicht zu gebrauchen. Deswegen folgt hier eine Auflistung 
der Schnittstellen vom Amiga. 


- Audio-{Stereo) und Videoschnittstelle (Composite, HF-Modulator) 

- RGB-Monitorausgang 

- Centronics-Schnittstelle [Druckerport) 

- Serielle Schnittstelle (RS 232) 

- zwei Gameports (für Maus, Joystick, etc.) 

- externe Diskettenlaufwerkschnittstelle (max. 3 Laufwerke) 

- Frpansionsport (Amiga 300.600. 1200) für Hardiwareerweiterungen 
jeder Art (Turbokarten, Speicher etc.) 

- Jastaturschnittstelle 

- Zorro IlMII-Bus für Erweiterungen jeder Art (Amiga 200930004000) 

- PCMCIA-Port (Amiga 6001200) 

- /DE-/SOS/-Controller (außer Amiga 3002000) 
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Wie die einzelnen Bausteine zusammenarbeiten verdeutlicht das 
folgende Blockschaltbild vom Amiga. 


Bild 1.1.a 





Customchipbereich 
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1.1.1 Die 680x0-Prozessoren 


Die Geschichte der 680x0-Prozessoren geht auf das Jahr 1977 zurück. 
Zu dieser Zeit war die TTL-Technik noch das NonPlusUltra. Die 
Entwickler setzten sich damals das Ziel, so viele Funktionen wie nur 
möglich in einen Silicium-Chip zu bringen. Das Projekt wurde 
MC68000 getauft, welcher der Nachfolger vom M(C6800 werden 
sollte. Dieser gehört zur 8-Bit-Microprozessor-Reihe von dem auch der 
6502-Prozessor abstammt, bekannt vom C-64er. Es wurden von 
vornherein bestimmte Richtlinien festgelegt, die verbindlich sein 
sollten für alle nachfolgenden Modelle. 


1. Familienarchitektur 


Die festgelegte Architektur der MC680x0-CPUs ist für alle Modelle 
verbindlich. Die Quantität der Implementierungen und Performance 
sollte immer nur vom Stand der Technik abhängıg sein. 


2. Flexibilität und Effektivität 


Die Prozessoren sollen immer leicht zu programmieren sein. Keine 
umständlichen Begrenzungen, Spezialfälle usw. 


3. Wirkungsbereich 


Die Architektur muß für eine Viekah/ von Anwendungen ausgelegt 
sem, damit er last "universell" einsetzbar St. 


4. Ausbaufähig 


£s wurden etliche Leistungsmerkmale für die 680x0-Reihe von An- 
rang an definiert (Fließkommaarithmetik, Zeichenkettenverarbeitung, 
MMU etc), Diese konnten in den ersten Modellen noch ganmıcht 
ımplementiert werden, weıl es noch nicht Stand‘ der Technik war. 
Außeroem wırd freier Speicherraum innerhalb der Architektur 
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freigelassen, um noch neue Funktionen im Wande/ des Fortschritts 
unterbringen zu können. 


5. Unterstützung von Hochsprachen 


Die Prozessoren enthalten Befehle die die Programmierung in einer 
Hochsprache unterstützen (LINK, UNLA). 


Der M(C68000-Prozessor 


Der 68000er Prozessor, welcher im Amiga 500, 1000, 2000 benutzt 
wird, besitzt eine Adreßbreite von 32 Bit und eine Daten bzw. ALU- 
Breite von 16 Bit. Die Taktfrequence beträgt bei der NTSC (USA) 
Version 7.15909 MHz und bei der PAL (Europa) Version 7.09379 
MHz. Der MC68000 kann 16 MegaßByte adressieren, wobei der 
Amiga nur maximal 9 MegaByte nutzen kann. Er besitzt 8 Daten- 
und 8-Adressregister (DO-D7 und AO-A7), einen UserStack- bzw. 
SuperVisorStack-Pointer (USP und SSP) und ein Statusregister, das den 
internen Status des Prozessors wiederspiegelt. Das Betriebssystem 
benutzt den SuperVisor-Modus, weil nur hier "gefährliche" Befehle 
(priviligierte) genutzt werden können (Zugriff auf SR, SSP usw.). 
Zusätzlich besitzt er noch eine 1KByte große Vektortabelle, welche die 
Adressen auf 7 mögliche Interrupt-Routinen und einige Exception- 
Routinen (Ausnahmebehandlung) beinhaltet. Die Anfangsadresse der 
Tabelle bei diesem Prozessor ist immer Null. Ab dem MC68010 gibt 
es ein VBR-Register, über das sich die Anfangsadresse der Tabelle 
ändern läßt. Nähere Beschreibungen finden Sie im Abschnitt 1.4. 


Der Prozessor unterstützt auch Direct-Memory-Acces, kurz DMA 
genannt. Diese beinhaltet die Übertragung von Daten zwischen 
externen Geräten und Systemspeicher, ohne den Prozessor damit zu 
belasten. Der Amiga macht davon aber keinen Gebrauch. Er hat 
dafür seine eigenen Kanäle (siehe Abschnitt 1.9). 
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Bild 1.1.1.a 


BITS: 


DRTENREGISTER 


ARDREBREGISTER 


USER-STACK-POINTER 


SUPERVISOR-STACK-POINTER 


PROGRAMM-COUNTER 





STATUS-REGISTER (System/User) 


Registersatz der 68888-CPU 


Die MC68000-CPU besitzt zwei Busse, einen synchronen und einen 
asynchronen. Der Prozessor selbst läuft im schnellen asynchronen 
Modus bei voller Taktfrequenz. Der synchrone Modus ist beim Amiga 
um den Faktor 10 langsamer als der asynchrone. Er dient zur 
Synchronisation mit anderen 8-Bit-Bausteinen, wie den ClAs 8520. 
Dadurch stand einem zur Einführung des 68000er eine Unmenge an 
Peripherie-Bausteinen zur Auswahl. 


Die Zeiten für die Befehle des 68000er und der anderen Prozessoren 


werden in Taktzyklen angegeben. Die Zeit für einen Taktzyklus läßt 
sich wie folgt berechnen: 


= 1/T (Frequence/Hz] = 1 / Periodendauerfs]) 
T=1/f => 1/7.09379 Mhz = 0,000000141 s = 141.ns 


/ Taktyklus beträgt bei der 68000er Pal-Version ca. 141 ns (Nanosekunden). 
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Eine ausführliche Beschreibung aller Prozessoren würde den Rahmen 
des Buches sprengen. Deswegen folgt hier zum besserem Verständnis 
nur eine kurze Pinbeschreibung der einzelnen Prozessoren. Beim 
68000er etwas ausführlicher und bei den restlichen nur die 
Veränderungen. Weitere Informationen zur Programmierung der 
CPUs folgt in den Abschnitten 1.10 bis 1.14. 








Bild 1.1.1.b 
Pinbelegung des 68888 mit BGignalrichtung 
D4 4 4 + D5 
D3 + 2 sr DE 
D2 nn 2 3 62 FD? 
D1 + 4 si rk DB 
De + 5 68 P 4 D9 
AS ee 6 >) D18 
uUD3 + ? + D11 
LD 4 8 «> D12 
— 9 e—) D13 
— 18 “—) 014 
r+— 11 ee D15 
BEACK —) 12 “= GND 
B —) 13 —+ n23 
VCC 14 —) A22 
LK —) 115 —) n21 
GND —) 116 &® e— UVCC 
+ 17? x; —) 128 
RESET SI 18 —) A119 
mn +- dı9 © —? 18 
4 28 © —> A1? 
— 21 wD —) fA16 
— 2 —) A15 
= 23 = n14 
IPLI R13 
irLS —+ n12 
FC2 4 —> A11 
FC1 r— — A1iB8 
FCB e— n9 
Ai +— —) 8 
n2 e—_ —) A? 
na r— —+ n6 
na 4 —) A5 





Ein Strich über ein Signalnamen steht für 
Low-Akt iv B-Aktivd. 


Beschreibung der Signale: 


Spannungsversorgung: VCC und GND 
Versorgungsspannung von 5 Volt (VCC) und Masse (GND). Die Anschlüsse 


sind für beide Seiten ausgelegt, damit kurze Signalwege eingehalten werden 
können. 
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Adreßbus: Al bis A23 


23 Leitungen welche immer die Adresse des aktuellen Befehls enthalten. Mit 
diesen Leitungen kann die CPU maximal 16 MByte adressieren (2°23 = 
8,388,608 Words = 8192 KWords = 16384 KByte = 16 MByte). Durch die 
fehlende AO-Leitung kann der Speicher immer nur wordweise angesprochen 
werden. Hier liegt auch die Ursache warum beim Ansprechen einer 
ungeraden Adresse mittels eines Word-Befehls (Z.B. move.w) der Rechner 
beginnt zu meditieren (Guru....). 


Datenbus: DO bis DI5 


Die Datenleitungen enthalten immer den aktuellen Wert einer Funktion. Der 
Wert kann maximal 16-Bit breit sein. Bei größeren Werten wird zweimal 
gelesen (Longword = 32 Bit) und bei kleineren (Byte = 8 Bit) sind entweder 
nur die unteren oder die oberen 8 Leitungen aktiv (siehe UDS/LDS). 


Takteingang: CLK 


Asynchrone Taktfrequenz für den Prozessor. Es sind je nach Ausführung 4, 6, 
8, 10, 12 und 16MHz Quarze anschließbar. Der Amiga wird mit 7,09379 
MHz (PAL) getaktet. 


Asynchrone Bussignale: AS, UDS, LDS, RW; DIACK 


Im schnellen asynchronen Modus signalisiert die CPU mit dem Ausgang AS 
(Adress-Strobe = gültige Adresse), daß die Adresse auf dem Adreßbus gültig 
ist. Ob jetzt an der Adresse über den Datenbus ein Wert gelesen oder 
geschrieben werden soll, entscheidet das R/W-Signal (Read/Write). Null 
bedeutet schreiben und 1 lesen. Wie breit jetzt der Wert ist (16 oder 8 Bit) 
entscheiden die Ausgangssignale UDS und LDS (Upper-/Lower-Data-Strobe = 
Obere-/Untere-Datenhälfte). Bei einem Word-Zugriff (16 Bit) sind beide 
Ausgänge auf Null, andernfalls einer von beiden auf 1. Da der Prozessor in 
der Regel nicht die gleiche Geschwindigkeit wie der Speicher hat, müssen 
diese Zugriffe synchronisert werden. Mit dem Eingang DTACK teilt der 
Speicher der CPU mit, das Daten übernommen wurden (DTACK = 1) bzw. 
bereit stehen (DTACK = 0). 
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Synchrone Bussignale: VMA, £, VPA 


Zur Synchronisation externer 8-Bit-Bausteine (CIA 8520) liegt am Ausgang E 
ein durch 10 geteilter Takt (Verbunden mit dem Phi2-Eingang der CIAs 
8520). Wird die Adresse einer der beiden ClAs angesprochen, wird über 
einen Adreßdecoder ein Low-Signal erzeugt. Dieses liegt am Eingang VPA 
(Valid Periphial Adress = gültige Peripherieadresse) und schaltet die CPU von 
dem asynchronen Modus in den synchronen, sobald sie mit dem VMA- 
Ausgang (Valid Memory Adress = gültige Speicheradresse) antwortet (VMA 
= 0). Jetzt muß die CIA innerhalb des Taktes E die Daten verarbeiten. 


Systernsteuersignale: HALT, RESET, BERR 


Einen Systemreset der CPU kann man durch setzen der Signale HALT und 
RESET auf O duchführen. Sobald diese Signale wieder auf 1 gehen, beginnt 
die 68000er CPU mit der Programmausführung bei der Adresse, die er im 
Speicher ab der Adresse 4 vorfindet. Möchte man nur einen Reset des 
Systems durchführen, ohne den Prozessorzustand zu verändern, setzt man nur 
die Reset-Leitung auf Null. Um den Prozessor anzuhalten muß man HALT auf 
O setzen. Jetzt wird der aktuelle Befehl noch ausgeführt und die CPU wartet, 
bis das Signal wieder auf 1 gesetzt wird. 


Mit dem BERR-Eingang (Bus-Error) kann man über eine externe Über- 
wachungsschaltung der CPU mitteilen, daß im System ein Fehler vorliegt. 
Sofern ein Fehler auftritt wird in eine Routine des Betriebssystems gesprung- 
en (Guru...). Bei einem doppelten BUS-Error hilft nur noch ein Reset (RESET 
und HALT = 0). 


CPU-Betriebszustand" FCO, FOL FC 


Wie schon erwähnt kennen die 680x0-Prozessoren einen User- und einen 
SuperVisor-Modus. Welcher Modus gerade vorliegt signalisieren folgende 
Ausgänge der CPU (siehe auch MC68020): 


FC2 FC1 FCO_ Zustand 

0 0 reserviert für Motorola 
Zugriff auf USER-Daten 
Zugriff auf USER-Programm 
reserviert für Anwender 
reserviert für Motorola 
Zugriff auf SuperVisor-Daten 


HHooo 
oOrHrOoo 
Horror 
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1ı 1 0 Zugriff auf SuperVisor-Programm 
1ı ı 1 CPU-Adre£bereich 


Das Amigasystem reagiert entsprechend den Signalen. Damit normalerweise 
nur das Betriebssystem im SuperVisor-Modus läuft. 


/nterrupteingänge: (IPLO, IPLT, IPLZ) 


Der Amiga besitzt 7 Interrupt Ebenen, was auf die 3-Bit-Zahl der CPU 
zurückzuführen ist (IPLO bis IPL2 = Interrupt-Pending-Level). Eine O bedeutet 
kein Interrupt und eine 7 ein Interrupt mit der höchsten Priorität. Bei einem 
erlaubten Interrupt legt der Prozessor die FCx-Ausgänge auf 1 und wartet auf 
Bestätigung durch das VPA-Signal. Danach wird aus dem dazugehörigen 
Auto-Interrupt-Vektor (#64 bis $7c = 7 mögliche Adressen) die Adresse des 
Interrupt-Programms geholt und ausgeführt (s. Abschnitt 1.8). 


Es gibt auch noch die Möglichkeit durch das DTACK-Signal der CPU zu 
antworten. Dabei handelt es sich um die Nicht-Autovektorielle Unter- 
brechung. Der Prozessor führt dann das Programm aus, welches an der 
dazugehörigen Nicht-Autovektoriell-Ebene steht ($100 bis $3ff). So kann man 
hardwaremäßig zwischen 192 verschiedenen Interrupts unterscheiden. Der 
Baustein der diesen Interrupt ausgelöst hat, muß den entsprechenden Vektor 
dann auf den Datenbus legen (0 bis 191). 


Signale für Buszuweisung: BG, BGACK, BR 
Diese drei Signale sind für den Direct-Memory-Access zuständig. Der Amiga 


macht davon aber keinen Gebrauch. Er hat seine eigenen DMA-Kanäle (siehe 
Abschnitt 1.9) 
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Die MC68008-, MC68010- und MC68012-CPU 


Der MC68008 ist die kleinere Version des MC68000. Er kann nur 
noch 1 MByte adressieren und besitzt auch nur noch einen 8-Bit- 
Datenbus. Bei Longword- bzw. Word-Operationen braucht der 
MC68008 doppelt so lange wie der MC68000. Erhältlich ist er mit 8 
und 10 MHz Taktfrequenz. Wegen des 8-Bit breiten Datenbusses wird 
dieser Prozessor im Amiga nicht eingesetzt. 


Beim MC68010 wurden einige Verbesserungen gegenüber dem 
MC68000 in der Architektur vorgenommen. Diese sind zwei neue 
Function-Code-Register (privilegiert) mit denen er in der Lage ist, 4 
lineare Speicherbereiche von je 16 MByte zu adressieren. 


Ab dem MC68010 gibt es jetzt auch ein Vector-Base-Register (VBR), 
mit dem die Anfangsadrese der 1 KByte großen Vektortabelle 
verschoben werden kann. Außerdem unterstüzt dieser Prozessor auch 
eine virtuelle Speicherverwaltung (siehe MMU-Abschitt). Diese 
ermöglicht die Auslagerung von RAM-Speicher auf Massenspeicher (z. 
B. Festplatte). Dafür ist aber noch eine externe MMU (Memory 
Management Unit) erforderlich, die für diese CPU aber schwer zu 
erhalten ist. Deswegen lieber gleich zu einem MC68020 oder höher 
greifen. Die Geschwindigkeit gegenüber einem MC68000 wurde um 
ca. 5 bis 10% gesteigert (interner & Byte Mini-Cache + Befehls- 
optimierung). Er ist auch 100% Pinkompatibel, so daß er (bei 
gleicher Taktfreq.) gegen einen MC68000 ausgetauscht werden kann. 


Der MC68012 ist ein Auslaufmodell und wird mangels Nachfrage seit 
1989 nicht mehr hergestellt. Bis auf die Bauform (84poliger PinGrid- 
Array-Gehäuse -> viereckig) und einem gekürzten Adreßraum (2x2 
MByte) ist er identisch mit dem MC68010. 
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Der MC68020-Prozessor 


Dieser Prozessor erschien 1984 und seine Leistungsdaten waren für 
die damalige Zeit revolutionär. Er besitzt alle Fähigkeiten seiner 
Vorgänger (MC68000 und MC680 10), hat eine Standartfrequenz von 
16 MHz (es gibt auch 12 und 20 MHz-Versionen), besitzt einen 32- 
Bit Daten- und Adreßbus, wodurch er 4 GByte adressieren kann, und 
ist durch einen internen Cache (256 Bytes-Instruktion-Cache) und eine 
Befehlsoptimierung erheblich schneller als seine Vorgänger. Die 
normale CPU (68000) braucht für einen Befehl mindestens 4 
Taktzyklen, beim MC68020 werden nur noch mindestens 3 Zyklen 
benötigt. Ab dieser Version finden wir auch das Dynamic-Bus-Sizing 
(bei Intel erst ab 1486), wodurch sich jetzt der Speicher dynamisch an 
die Busgröße anpassen läßt. Der Prozessor kann die Daten dabei 
Byte-, Word- oder Longwordweise über den Bus transportieren. Dabei 
werden die Daten in Bytes zerlegt und nacheinander über den 
Datenbus geschoben. 


Der MC68020 hat eine 3-Stufen-Befehls-Pipeline (Prefetch Queue). 
Das bedeutet, während ein Befehl abgearbeitet wird, werden schon 
die nächsten zwei Words geholt, bedingt durch die optimale 32-Bit- 
Datenbusausnutzung. Dieses geschieht in Stufen. In der letzten Stufe 
wird der Befehl dekodiert und dementsprechend mit dem nächsten 
Words verfahren (entweder Daten für Befehl oder neuer Befehl). 
Handelt es sich nicht um einem Maschinenbefehl, so wird eine 
Exception ausgelöst (siehe Abschnitt 1.7). Beim Prefetch-Queue 
werden die Daten (Words) durch die Stufen geschoben, analysiert 
und entsprechend bearbeitet. 


Viele Befehle wurden optimiert, vor allem die Multiplikation- und 
Divisionsbefehle. Ein On-Chip-Barrel-Shifter (wie beim Blitter) sorgt für 
das Rotieren der Bits bei Schiebe- und Rotationsbefehlen ohne 
Zeitverlust (bis zu 32 Positionen in einem Taktzyklus). 
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Die wichtigsten Elemente für die Bearbeitung eines Maschinenbefehls 
(Bus- u. allgemeines Steuerwerk, sowie Rechenwerk) können ab dem 
MC68020 alle unabhängig voneinander arbeiten. Kontrolliert wird 
alles über die Ablaufsteuerung. 


Seit dem MC68020 brauchen Befehle, Word- u. Longworddaten nicht 
mehr auf geraden Adressen beginnen. Jedoch sollte unbedingt darauf 
geachtet werden, daß dem doch so ist, zwecks Kompatibilität zum 
MC68000. 


Neu ist jetzt auch ein eingebautes Coprozessor-Interface, welches 
ermöglicht bis zu acht Coprozessoren an die CPU anzubinden. Diese 
Verfügen über einen eigenen Befehlssatz, der direkt in den normalen 
Maschinencode eingefügt werden kann (siehe Abschnitt 1.1.2). 


Der 68020-Prozessor wird in dem Amiga 1200 in abgespeckter 
Version eingesetzt (MC68EC020). Er Verfügt nicht über eine 
Coprozessor Schnittstelle, hat nur 24 Adreßleitungen und einige 
Steuerleitungen wurden auch entfernt. 


Seite 13 


Hardwaregrundlagen Kapitel 1 


Bild 1.1.1.c 
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Pinbelegung- und beschreibung des MC 68020 


Den MC68020 gibt es in drei Gehäuseformen. Zwei Pin-Grid-Array- 


Gehäuse (Anschlüsse unter dem Chip) und das Surface-Mount-Gehäuse 
(Anschlüsse außen am Chip). 
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Bild 1.1.1.d 
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Wie beim MC68000 lassen sich auch hier die Signale in Gruppen 
einteilen. 


Bild 1.1.1.e 
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Beschreibung der Signale: 
Takteingang: CLK 


Takteingang für den Prozessor (12,5 bis 33 MHz, Amiga 1200 = 14 MHz). 
Zu beachten ist, daß die MC680x0-Prozessoren dynamisch sind. Das heißt, 
daß solange die Spannung angelegt ist, auch der Takt anliegen muß. 
Ansonsten kommt es zu erhöhten Stromfluß, welcher den Chip zerstören 
könnte. Beim Amiga ist aber eine Schutzschaltung integriert. 
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Adreßbus: AOA31 (A23) und AS 


32 unidirektionale (in eine Richtung) Adreßleitungen. Damit können 4 GByte 
adressiert werden. Der AS-Ausgang (Adreß-Strobe-Signal) wird aktiv (Low), 
wenn eine gültige Adresse anliegt. Bei einem Cache-Zugriff ist er inaktiv 
(High). 


Datenbus: DO-D31] u. RW; DS 


32-Bit breiter, bidirektionaler (in beide Richtungen) Datenbus. Die R/W- 
Leitung bestimmt ob die Daten gelesen oder geschrieben werden (s. 
MC68000). Der DS-Ausgang (DataStrobe) signalisiert beim Schreiben die 
gültigen Daten (DS=0 => gültige Daten liegen am Ausgang DO-D31). Ist 
dieses Signal High, so kann die externe Peripherie Daten auf den Datenbus 
legen. 


Signale: SIZO u. SIZI: 


Die Ausgänge SIZO und SIZ1 bestimmen die Operandengröße (B,W,L), also 
wieviel Bytes die CPU übertragen muß. 


SIZ1 SIZO Operandengröße 
0 0 _ Longword 

Byte 

Word 

drei Bytes 


= 60 
-o0-_- 


olynamische Bussteuersignale: DSACKO, DSACKT 


Mit diesen Signalen läßt sich die Datenbreite (Portgröße) der CPU festlegen. 
Beim MC68000 gibt es die Signale UDS und LDS mit denen auf die oberen 
oder unteren 8-Bit des Datenbusses zugegriffen werden konnte. Dieses war 
für den Anschluß von 8-Bit-Peripherie erforderlich. Mit dem DTACK-Eingang 
(MC68000) wurde dann die Rückmeldung von externer Peripherie für die 
Datenverarbeitung bewerkstelligt. Da es sich bei dem MC68020 um einen 
echten 32-Bit Prozessor handelt, wurde ein weiterer Eingang en. 
(auch beim MC68030), das DSACK1-Signal. Mit DSACKO und DSACKI läßt 
sich jetzt die Portgröße beliebig wählen. 
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DSACKI _DSACKO Portgröße 


0 0 32-Bit 

0 1 16-Bit 

1 0 8-Bit 

1 1 Wartezyklen 


8-Bit-Bausteine schließt man "einfach" an DSACKO und 16-Bit Bausteine an 
DSACK1 (bei lowaktiven Ausgängen). Die Leitungen müssen immer auf den 
höherwertigen Adreßleitungen des Adreßbusses angeschlossen werden. Das 
"einfach" ist natürlich mit Vorsicht zu genießen. Die Taktzyklenanzahl ist jetzt 
abhängig von der Operandengröße und der Portbreite. Eine Longword- 
Operation über einen 8-Bit-Port dauert doppelt solange wie über einen 16- 
Bit-Port. Aus den Signalen AO, Al SIZO und SIZ1 muß jetzt noch eine Byte- 
Freigabe-Schaltung generiert werden, damit 8-Bit-Peripherie angeschlossen 
werden kann (synchroner Modus des MC68000 => Signale: VMA, E, VPA). 


Steverausgönge für Buffer und externen Cache: EOS, O6, DBEN 


In der Regel sind heutzutage die Chips schneller als die angeschlossenen 
Speicher. Mit dem ECS-Signal wird ein vorgezogenes Adreß-Strobe-Signal (AS) 
erzeugt, was für ein frühes Chip-Select verwendet werden kann. Eine 
ausführliche Beschreibung würde hier, wie bei anderen Signalen auch, zu 
weit führen. Dafür gibt es entsprechende Literatur. 


Das OCS-Signal verhält sich ähnlich wie das ECS-Signal. Es wird nur bei einem 
Operandenzugriff aktiv (Low). Das DBEN-Signal wird beim Lesen einen Takt 
später aktiv, nach dem Buszyklus und zusammen mit DS deaktiviert. Beim 
Schreiben wird es mit AS aktiv und am Ende des Buszyklus deaktiviert. 


umteilbarer Zyklus: RMC 


Das Ausgangssignal RMC (Read-Modify-Write-Cycle) zeigt einen unteilbaren 
Zyklus an. Das bedeutet, daß die CPU während der Abarbeitung eines 
Befehlszyklus nicht unterbrochen werden kann bzw. sollte. Dieses Signal ist 
beim MC68020/30 vorhanden und kann zur Kommunikation zwischen 
verschiedenen Prozessoren verwendet werden (Multi-Prozessor-System). 


Interruptsteuverung: IPLO bıs IPL2, IPEND, AVEC 
Die Funktion ist wie beim MC68000, nur das jetzt das AVEC-Signal 


(AutoVector) für das VPA-Signal die Bestätigung eines Interrupts übernimmt. 
Interrupts werden immer am Ende eines Befehlszyklus abgearbeitet, nicht 
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während. Über die DSACK-Signale werden die USER-Vektoren generiert (s. 
DTACK beim MC68000). Über das Statusregister kann die Interruptebene 
maskiert werden (Autovektor O bis 7). Die darin enthaltenden Maskenbits IO 
bis I2 stellen die Interruptgrenze da, bis zur welcher ein Interrupt erlaubt ist 
(siehe Kapitel 1.8). Bei einem gültigen IRQ) wird das IPEND-Signal aktiv (Low) 
und kann als Interruptbestätigung genutzt werden. Es geht erst wieder auf 
High (inaktiv), wenn sich die Ebene ändert (IPLx) oder eine höhere Maske in 
das Statusregister (SR) gesetzt wird. 


Buszugriffsteversignale: BR, BG, BGACK 


Diese Signale haben die gleiche Bedeutung wie beim MC68000. Sind für 
den Einsatz im Multi-Master-Betrieb notwendig (mehrere CPUs etc.). Wenn 
also mehr als ein Prozessor auf den Daten- bzw. Adreßbus zugreift. Der Bus 
wird durch BR (Bus Request) angefordert und mit BG/BGACK (Bus Grant/ Bus 
Grant Acknoledge) freigegeben. 


Systernstewersignale: HALT, BERR, RESET 


Über die Resetleitung wird der Prozessor in seinen Ausgangszustand versetzt. 
Dabei werden drei Reset-Fälle unterschieden: 


- Einschalt-Reset (PowerOn) 
- Knopforuck-Reset (Cr! + left Amiga + right Amiga) 
- Reset-Bereh/ 


Beim Einschalt-Reset muß das Signal für > 100ms aktiv sein (ohne die HALT- 
Leitung, wie beim MC68000). Danach befindet sich die CPU im Startzustand 
und beginnt mit der Programmausführung über Adresse 4. 


Der Knopfdruck-Reset verhält sich ähnlich, allerdings muß das Signal für 
>10 Taktzyklen aktiv bleiben. Ein längerer Tastendruck wäre jedoch 
empfehlenswert, um wirklich sicher zu stellen, daß alles im Rechner 
zurückgesetzt wurde. 


Beim Software-Reset durch den Reset-Befehl wird die Leitung als Ausgang für 
512 Takte aktiv (Low). Dieser Befehl ist privilegiert und kann für das 
Zurücksetzen von externer Peripherie verwendet werden. Nach dem Befehl 
wird gleich mit dem darauffolgenden weiter gearbeitet. 
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Das BERR-Signal unterbricht den gerade aktiven Taktzyklus und das 
Programm, welches in Adresse 8 steht, wird ausgeführt (BUS-Fehler). 


Mit dem HALT-Signal kann hardwaremäßig ein Trace-Modus durchgeführt 
werden. Bei Aktivierung wird der aktive Befehl noch abgearbeitet und 
anschließend hält die CPU an, bis das Signal wieder inaktiv wird. 


Cachesteuerung: CDIS 


Mit diesem Signal käßt sich der Cache hardwareseitig ausschalten (Vorrang 
zur softwareseitigen über das Cache-Steuerregister). Der interne Inhalt des 
Cache-Speichers geht dabei nicht verloren. 


CPU-Betriebszustand FCO bis FCZ 


Die Funktion entspricht der des MC68000. Mit diesen drei Bits können 8 
Adreßbereiche (jeweils 4 GByte) unterschieden werden. Mit dem MOVES- 
Befehl (Move to Alternate Adress Space) kann man auf die 3-Bit-Register SFC 
und DFC des MC68020/30/40 zugreifen. Wenn mit Hilfe des Befehls gelesen 
wird, so werden die Informationen aus dem SFC-Register und beim Schreiben 
aus dem DFC-Register geholt. Mit dem MOVEC-Befehl können die beiden 
Register programmiert werden. 
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Beim Amiga 3000/4000 wird der MC68030 eingesetzt. Er ist, wie der 
MC68020, ein echter 32-Bit Prozessor und die Taktfrequence beträgt 
16 oder 25 MHz. Der MC68030 kann 4 GigaByte adres-sieren, wobei 
aber nur etwas über 1 GigaByte maximal genutzt werden können. Er 
wurde 1987 eingeführt und verfügt jetzt über eine interne PMMU 
(Page-Memory-Management-Unit) und einen zusätzlichen Datencache 
(256 Bytes). 


Das Chip-Layout und Bussteuerwerk wurden auch nochmal 
überarbeitet. Durch die verkürzten Signalwege (intern) ergeben sich 
jetzt höhere Taktfrequenzen (16, 20, 25, 33, 50 MHZ) und kürzere 
Zeiten für den Datentransfer. Wegen diesen Erneuerungen sind einige 
zusätzliche Signale hinzugekommen. Es gibt jetzt einen neuen 
synchronen und einen neuen Burst-Fill-Modus. Beim ersten Modus 
dauert ein Busabschluß nur ganze 2 Taktzyklen. Der Burst-Fill-Modus 
dient zum schnellen Füllen der Cache-Speicher (max. 4 Longwords in 
5 Taktzyklen). Dem MC68030 stehen Leitungen zur Verfügung, mit 
denen sich die Caches ausschalten lassen. 


Die kostengünstigere Version ist der MC68EC030 (EC = Economy). 
Hier wurde die PMMU entfernt, aber die TTx-Register hat man bei- 
behalten um die Caches weiter Steuern zu können. Der MC68EC030 
ist pinkompatibel und hat auch ein identisches Buszeitverhalten wie 
die Voll-Version. 
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Pinbelegung- und beschreibung des MC 68030 


Den MC68030 gibt es in drei Gehäuseformen. Zwei Pin-Grid-Array- 
Gehäuse (Anschlüsse unter dem Chip) und das Surface-Mount-Gehäuse 
(Anschlüsse außen am Chip). 


Bild 1.1.1.9 
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Wie beim M(C68020 lassen sich auch hier die Signale in Gruppen 
einteilen. 


Bild 1.1.1.h 
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Beschreibung der Signale: 
dynamische Bussteverung: Six, DSACKx 


Die dynamische Bussteuerung läuft bis auf wenige Ausnahmen, wie beim 
MC68020 ab. Die Unterschiede sind folgende: 


Beträgt die Portbreite wenige als 32-Bit (16/8-Bit), wird bei aktiviertem 


Daten-Cache trotzdem ein Longword gelesen (um den Cache zu füllen). Die 
SIZx-Leitungen zeigen im Gegensatz dazu die kleinere Portgröße an. 
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Der MC68030 erlaubt nicht das Mischen von Datenbreiten, wie der 
MC68020. Gearbeitet werden muß immer mit der gleichen Portgröße in 
einem Buszyklus, auch wenn die SIZx-Signale eine andere anzeigen. 


Cache-Steuersignale u. Burst-Modus: CDIS, CHN, CIOUT, CBREQ, CBAK 


Das CDIS-Signal hat die gleiche Bedeutung wie beim MC68020 (Caches = 
inaktiv). Die anderen vier Signale sind neu hinzugekommen und haben 
folgende Bedeutung: 


Der CBREQ-Ausgang (Cache-Burst-Request) wird aktiv (Low), wenn die CPU 
für den Burst-Mode bereit und dieser im Cache-Steuerregister (CACR) frei- 
gegeben ist. Dies bedeutet, daß Daten in den Befehls- oder Datencache 
aufgenommen werden können. Im besten Falle können vier Longwords in 
fünf Taktzyklen eingelesen werden. Bei der normalen Datenübertragung 
(ohne Burst) braucht man acht (synchron) oder 12 (asynchron) Taktzyklen. Es 
sind auch andere Burstzeiten durch das STERM-Signal möglich (Verzögerung 
durch Synchronisation). 


Der CBACK-Eingang (Cache-Burst-Acknowledge) wird durch die externe 
Hardware aktiviert (Rückanwort), wenn Daten für den Burst-Mode anliegen. 


Der CIIN-Eingang (Cache Inhibit IN) signalisiert bei Aktivierung, daß die 
Daten des aktuellen Buszyklusses nicht in den Cache übernommen werden 
dürfen. Ein bereits laufender Burst-Zyklus wird abgebrochen. 


Der CIOUT-Ausgang (Cache Inhibit OUT) signalisiert bei Aktivierung, daß die 
vorhandene MMU einen Bereich (Page) selektiert hat (geschützt), dessen 
Daten nicht in den Cache übernommen werden dürfen (siehe Kapitel 1.13). 


Ssynchrone Bussteverung: STERM 


Der MC68030 bietet als einziger Prozessor noch einen weiteren synchronen 
Buszyklus, den "Synchronous Termination". Dafür existiert das STERM-Signal. 
Die besonders interne enge Bahnführung und die Modifikation der 
Bussteuerung ermöglichen die Abwicklung eines Buszyklusses in nur zwei 
Taktzyklen. Voraussetzung sind allerdings Speicher mit Zugriffszeiten < 45ns 
bei einer Frequenz von 20 MHz. Im Gegensatz zur synchronen Bussteuerung 
mit den DSACKx-Signalen verwendet die synchrone Bussteurung mit dem 
STERM-Signal immer einen 32-Bit-Datenbus (Portgröße = 32 Bit), läßt also 
keine dynamische Bussteuerung zu. 
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Der Burst-Fill-Modus muß immer mit einem STERM-Signal abgeschlossen 
werden. Für den nächsten Buszyklus kann bereits wieder mit den DSACKx- 
Signalen auf den Datenbus zugegriffen werden. 


Emulator-Signale: REFILL, STATUS, MMUDIS 


Diese Signale dienen zur Emulation und Logikanalyse mit der CPU. Da sich 
durch die Cache und MMU-Programmierung der Programmablauf nicht mehr 
verfolgen läßt, wurden die Signale REFILL, STATUS und MMUDIS eingeführt. 
Seit dem MC68020 existiert das CDIS-Signal, mit dem sich die Caches 
ausschalten lassen. 


Über die Status-Leitung lassen sich einige interne Informationen auslesen, wie 
Befehlsende, Start einer Exception oder doppelter BUS-Fehler (Abhängig von 
der Zeit in Taktzyklen, die das Signal aktiv ist). Das REFILL-Signal signalisiert 
das Auffüllen der Pipeline. Mit dem MMUDIS-Eingang kann man die 
Adreßübersetzung der MMU verbieten. Die logischen Adressen entsprechen 
dann den physikalischen. 


Die restlichen Signaf-Gruppen haben die gleichen Funktionen wie 
beim MC680Z20. 
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Der MC68040-Prozessor 


1990 erschien der MC68040. In ihm wurden ein Fließkommaprozes- 
sor (FPU), zwei Speicherverwaltungseinheiten (PMMUs) und zwei 4 
KByte große Befehls- und Daten-Caches integriert. Dafür wurden 
1.200.000 Transistoren in dem Chip untergebracht. Um die 
Funktionstüchtigleit des MC68040 garantieren zu können, enthält er 
5 Pins, über die verschiedene Tests gefahren werden können. Die 
Tests werden über einen eigenen Takt-Eingang verarbeitet. Erhältlich 
ist der Prozessor von 20 bis 50 MHz (auch 66 MHz). Bei dieser 
hohen Taktfrequenz können die angeschlossenen Speicher natürlich 
nicht mithalten. Deswegen wurde der Takt für den Bus durch zwei 
geteilt. Intern arbeitet die CPU mit dem vollen Takt. Für die PMMUs 
wurde jetzt eine Hardwarelogik, statt dem Microcode verwendet. 
Dadurch konnte die Geschwindigkeit nochmals gesteigert werden. 
Allerdings sind jetzt nur noch 4 oder 8 KByte Seitengrößen wählbar. 
Die Pipeline des MC68040 ist jetzt 6-stufig, wodurch ein Befehl nur 
noch durchschnittlich 1,3 Taktzyklen andauert. Die integrierte FPU ist 
nur 3-stufig und enthält auch nicht alle Befehle wie ein MC68881/2. 
Diese werden über die 68040er.library emuliert. Ein 64x64-Bit- 
Hardware-Multiplizierer (neue Befehle) und ein 67-Bit-Barrel-Shifter 
sorgen weitere Rechenpower. 


Es gibt den MC68040 auch als EC- und LC-Version. Beide sind 
pinkompatibel und haben auch das gleiche Buszeitverhalten. Der 
MC68ECO40 hat weder PMMU noch FPU, beim MC68LC040 wurde 
nur die PMMU entfernt. Die Prozessoren der 40er-Reihe werden nur 
im Amiga 4000 oder auf Turbokarten eingesetzt. 


Seite 27 


Hardwaregrundlagen Kapitel 1 


Bild 1.1.1.i 
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Die EC-Version (MC68ECO4WV60) enthält noch die Register: 


DACRO = Data-Access-Control-Register-O0 
DACR1 = Data-Access-Control-Register-i 
IACRO = Instruction-Access-Control-Register-O0 
IACR1 = Instruction-Access-Control-Register-ıi 


Alle Register sind 32-Bit breit. 


Pinbelegung- und rei des MC 68040 


Den MC68040 gibt es im 170-poligen Pin-Grid-Array Gehäuse 
(Anschlüsse unter dem Chip). 


Bild 1.1.1.j 
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Wie beim MC68030 lassen sich auch hier die Signale in Gruppen 


einteilen. 


Bild 1.1.1.k 
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Beschreibu r Signale: 


Die Bus-Struktur und das Zeitverhalten einiger Signale haben sich 
beim MC68040 gegenüber den vorherigen Modellen geändert, was 
eine Umbenennung der Signale zur Folge hatte. Da die Funktionen 
aber nur geringfügig abweichen, folgt eine Tabelle die "gleiche" 
Signale gegenüber stellt (Achtung - sind nicht identisch). 


MC68040 (6802 

TA DSACKx, STERM 
TEA BERR 

TS AS 

TTx, TMx FCx 

BB BGACK 

PSTx HALT, STATUS 
LOCK RMC 

MDIS MMUDIS 

RSTI RESET (IN) 
RSTO RESET (Out) 
TBI CBREQ 

TCI CIIN 


Prozessor Status: PSTO bis PST3 


Diese vier Bits spiegeln den aktuellen Zustand der CPU wieder. Die Signale 
können zu Diagnose- oder Emulatioszwecke genutzt werden (ähnlich dem 
STATUS- und REFILL-Signal beim MC68030). 


PSTx-Bits 

3210 i 

0000 Fortsetzung des laufenden Befehls (USER-Start) 

0001 Ende des laufenden Befehls (USER-Mode) 

0010 Verzweigung nicht durchgeführt (USER) und Ende des laufenden Befehls 
0011 Verzweigung durchgeführt (USER-Mode) u. Ende des laufenden Befehls 
0100 User-Table-Search 

0101 CPU im HALT-Zustand wegen doppeltem BUS-Fehler 

0110 reserviert 

Bam reserviert 

1000 wie 0000, nur für SuperVisor-Mode 

1001 wie 0001, nur für SuperVisor-Mode 

1010 wie 0010, nur für SuperVisor-Mode 

1011 wie 0011, nur für SuperVisor-Mode 

1100 wie 0100 für SuperVisor 
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1 CPU im STOP-Zustand, aufgrund des STOP-Befehls 
) RTE-Befehl wird ausgeführt 
1 Stackablage für eine Exception 


Adreßbus: AO bis A3] 


Mit diesen 32 Adreßleitungen können 4 GByte adressiert werden. Bisher 
waren die Leitungen alles Ausgänge. Jetzt sind die Signale bidirektional (in 
beide Richtungen), was für die SNOOP-Fähigkeit erforderlich ist. Doch dazu 
später mehr. Das TS-Signal (Transfer-Start) hat hier die gleiche Funktion wie 
das AS-Signal (Adreß-Strobe) bei den vorherigen Modellen. 


CPU-Berriebszustand für Datentransfer: TMO bis TM2, TIO u. IT] 


Der MC68020/30 konnte mit den FCx-Leitungen (Function-Code) acht 
verschiedene Adreßbereiche (zu je 4 GByte) unterscheiden. Beim MC68040 
wurde die Signale durch andere ersetzt (TTx und TMx). Die Transfer-Mode 
(TMx) und Transfer-Type -Signale (TTx) können mehr als acht Adreßbereiche 
unterscheiden. Die TMx-Signale liefern ein Ergebnis in Abhängigkeit der 
TTx-Signale. 


IT1 TIO Tra -T 

0 0 Normaler Zugriff (ähnlich den FCx-Signalen) 

0 1. MOVEI6-Befehl (transportiert 16 Bytes - nur beim MC68040 integriert) 
1 0 alternativer logischer Adreßbereich 

1 1 Bestätigung-Zyklus (Breakpoint/Interrupt) 


Die TMx-Signale haben bei den ersten beiden Zuständen der TTx-Signale 
folgende Inhalte: 


TM2 TM1 TMO Zustand 

) Daten-Cache-Push 
Zugriff auf USER-Daten 
Zugriff auf USER-Programm 
PMMU Tablewalk für Daten 
PMMU Tablewalk für Programm 
Zugriff auf SuperVisor-Daten 
Zugriff auf SuperVisor-Programm 
reserviert 


FrHRrPPrROooo 
HFrooHrroo 
Horororo 


In Bezug auf das DFC- und SFC-Register gilt das gleiche wie beim MC68020. 
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Signale: SIZO bis SIZJ und TA 


Die Ausgänge SIZO und SIZ1 bestimmen die Operandengröße (B,W,L), also 
wiviel Bytes die CPU übertragen muß. 


SIZI SIZO 
0 0 Longword 
u 3 Byte 
1 0 Word 
1 1 16 Bytes 


Im Gegensatz zum MC68020/30 transportiert die CPU bei der SIZx- 
Kombination 11 immer 16 statt 3 Bytes. Dieses entspricht einer Cache-Zeile 
beim MC68040 (MOVE16-Befehl ). Der MC68040 läßt auch nur noch ein 32- 
Bit breite Portgröße zu. 


Das TA-Signal (Transfer-Acknoledge) hat eine ähnliche Funktion wie die 
DSACK-Signale bzw. das STERM-Signal des MC68030. Es dient als Abschluß 
eines Buszyklus bzw. zum Einfügen von Wartezyklen. Über dieses Signal kann 
ein externer Speicherzyklus in nur zwei Taktzyklen durchgeführt werden. Der 
MC68040 kennt nur noch den synchronen Modus (einzelne Buszyklen oder 
Burstzyklus). Er ist in der Lage auf ungerade Adressen zuzugreifen, obwohl 
ein 32-Bit-Port vorhanden ist. Dabei läßt die Performance erheblich nach. 


Für den Anschluß von 8- oder 16-Bit-Peripherie, ist es wie auch bei den 
anderen Prozessoren notwendig aus den Signalen AO, Al und SIZO, SIZ1 eine 
Byte-Freigabe-Schaltung zu generieren (Signale BEO bis BE3 beim MC68060). 


Über das TBl-Signal (Transfer-Burst-Inhibit) kann der Burst-Modus unterdrückt 
werden. Dann werden die vier Lonwords (Burst-Mode) in vier "normale" 
Buszyklen zerlegt. 

Die Signale LOK, LOCKE 

Mit dem LOCK-Signal wird ein unteilbarer Zyklus angezeigt, sobald dieser 
eingeleitet wurde. Wenn ein unteilbarer Zyklus zu Ende geht, kommt es zur 
Aktivierung des LOCKE-Signals. 

/nteruptstewerung: IPLx, AVEG IPEND, TA 

Der Interuptablauf enspricht dem wie beim MC68020, nur das hier das TA- 


Signal statt den DSACK-Signalen als Interruptbestätigung für die User- 
Vektoren fungiert. 
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Buszugriffssteuersignale: BR, BG, BB 


Die Signalrichtung der BR- und BG-Signale ist genau umgekehrt zu denen 
des MC68020/30. Wenn mehrere CPUs sich einen BUS teilen müssen, so 
wird mit dem BR-Ausgang der BUS verlangt. Über den BG-Elngang bekommt 
die CPU die Bestätigung, wenn der BUS frei ist. Im Gegensatz zu den 
anderen Prozessoren muß der Master (zentraler BUS-Arbiter) nicht nur den 
BUS für die anderen CPUs verwalten, sondern auch den unteilbaren Zyklus 
über di Signale LOCK und LOCKE.. Ob der BUS frei ist, erkennt der Master 
am BB-Signal, welche von allen CPUs zusammengefaßt und dem Master 
zugeführt werden. 


Systemsteuerung: RSTI, RSTO, TEA 


Die RESET-Leitung von den vorherigen Prozessoren wurde jetzt auf zwei 
Leitungen verteilt. Die Funktion ist aber gleich geblieben. Über das RSTI- 
Signal kann die CPU zrückgesetzt werden (wie Fälle 1 und 2 bei MC68020). 
Beim RESET-Befehl geht jetzt der RSTO-Ausgang für 512 Taktzyklen auf Null 
(aktiv). Der prinzipielle Ablauf ist beibehalten worden, nur die Zeiten haben 
sich geringfügig geändert. 


Ein BUS-Zyklus kann beim M(C68040, neben dem TA-Signal auch mit dem 
TEA-Signal beendet werden. Die Funktion entspricht etwa dem des BERR- 
Signals beim MC68030. 


Takteingang: BÜLR, PCIK 


Der MC68040 arbeitet ausschließlich mit einem synchronen BUS. Für die 
externe langsamere Hardware gibt es den BCLK (BUS-Takt = 0,5 fache des 
PCLK). Intern arbeitet die CPU mit dem PCLK-Elngang (Prozessor-Takt). 


Zmulsatorunterstützung u. Cachesteverung: CDI/S, MDIS, CIOUT, TC, TBl 


Die Funktion entspricht der vom M(C68030. Die TCI- und TBIl-Signale 
"ersetzen" jetzt die CBREQ- und CIIN-Signale. Mit der Aktivierung von TCI 
(Transfer-Cache-Inhibit) werden die aktuellen Daten eines Buszyklusses nicht 
in die Caches übernommen. Durch die Aktivierung von TBI (Transfer-Burst- 
Inhibit) wird der CPU mitgeteilt, daß der angeschlossene Peripherie-Baustein 
nicht den Burst-Modus unterstützen kann. 
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Der Burst-Modus kann nicht wie beim MC68030 über das CACR-Register 
(Cache-Steuer-Register) unterbunden werden. Er kann lediglich durch das TBI- 
Signal in einzelne BUS-Zyklen zerlegt werden. 


Snoogp-Steuersignale: SCO, SC], Mi 


Diese Signale sind im Zusammenhang mit den Caches für den Multi-Master- 
Betrieb erforderlich. Wenn sich Daten im internen Cache befinden und eine 
andere CPU ändert den Speicher, mit dem dieser Cache zuvor aufgefüllt 
wurde, so bemerkt das die Snoop-Logik ("Schnüffel"-Logik) und deklariert 
den Cache-Eintrag als "dirty" oder aktualisiert ihn. 


Test-Mode-Signale: TCK, TMS, TDI, TDO, TRST 


Über diese fünf Signale können erstmals Board-Tests gefahren werden, um zu 
überprüfen, ob die entwickelte Schaltung mit diesem CHIP auch so 
funktioniert wie geplant. Mit den TDI- und TCK-Eingängen können Testfolgen 
(Boundary Scan) eingeleitet werden, die dann auf den Anschlüssen der CPU 
erscheinen. Die Signale haben dabei folgende Bedeutung: 


TMS = Test-Mode-Select (Testbetrieb aktivieren) 
TCK = Test-Clock (Taktfrequenz für den Testbetrieb) 
TDI = Test-Data-IN (Testdaten einlesen) 

TDO = Test-Data-OUT (Testergebnis auslesen) 

TRST = Test-Reset (Testbetrieb reseten) 
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Der MC68060-Prozessor 


Der MC68060 ist seit 1994 auf dem Markt und enthält über 2,5 
Millionen Transistorfunktionen. Er wird nur noch in der 3,3 V 
Technologie gebaut und besitzt keinen Hochstrommodus (50mA 
Leitungstreiber), wie der MC68040. Die meisten Signale können jetzt 
bis zu 19mA treiben. Dieser Prozessor ist der derzeit schnellste der 
MC680x0-Reihe und wird wohl auch der Letzte sein. Denn Motorola 
setzt die Entwicklung verstärkt auf RISC-Prozessoren. 


Die ungeheure Leistungssteigerung gegenüber dem MC68040 wurde 
durch eine "superscalare Integer Unit" erreicht. Alle bisherigen 
Prozessoren enthielten nur eine einzige Integer-Unit (Rechenwerk für 
ganzzahlige Operationen). Das bedeutet, daß der MC68060 jetzt zwei 
unabhängige Execution-Pipelines (Bearbeitungskanäle) und Execution- 
Units (Bearbeitungseinheiten) besitzt. Diese können bis zu zwei 
Integer-- und einen Branch-Befehl (Sprung) in einem Taktzyklus 
parallel auszuführen. 


Die beiden Caches wurden auf 8 KByte vergrößert. Hinzugekommen 
ist noch eine "Branch-Cache-Unit" (Sprung-Zwischenspeicher-Einheit) 
für 256 Einträge. Sprünge, die sich in diesem Cache befinden, sind 
auf keinen einzigen Taktzyklus mehr angewiesen. 


Der MC68060 ist fast pinkompatibel zum MC68040. Einige Signale 
wurden geändert und einige sind noch hinzugekommen. Leider sind 
auch einige Befehle (CAS2 etc.) entfernt worden, wodurch dieser 
Prozessor nicht mehr 100%ig aufwärtskompatibel ist. Die fehlenden 
Befehle werden beim Amiga über Software emuliert - durch einen 
neuen Exception-Vektor. 


Bei den Prozessoren MC68020/30/40 mußte für den Anschluß von 8- 
und 16-Bit-Periepherie immer eine Byte-Freigabe-Schaltung entwickelt 
werden (Erzeugung der Signale BSx). Der MC68060 hat diese 
Schaltung bereits integriert und liefert dafür die fertigen Signale (BSO 
bis BS3). 
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Den MC68060 gibt es auch als EC- und LC-Version, mit den gleichen 
Einschränkungen wie beim MC68040. Die Taktfrequenz geht bis 
66MHz (vorläufig). Dieser Prozessor wird bisher in keinem Amiga 
serienmäßig eingesetzt. Allerdings liefern einige Firmen Turbokarten 
für den Amiga 1200/4000, die einen M(68060 beinhalten. In 
Zukunft soll auch der Amiga 4000 mit eingebauter Turbokarte 
ausgeliefert werden. 


Bild 1.1.1.1 
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Wie beim MC68040 lassen sich auch hier die Signale in Gruppen 
einteilen. 
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hreibu ignale: 


Adreßbus: ADA3T, CLA 


Funktion wie beim MC68040. Der CLA-Eingang hat nur beim Burst-Modus 
eine Bedeutung. Ist er aktiv (Low), so werden die Adreßleitungen A3, A2 
hochgezählt (inkrementiert), andernfalls verhalten sich die Signale wie beim 
MC68040. 


Die Signale haben die gleiche Bedeutung, wie beim MC68040. Jetzt ist noch 
beim alternativen Zugriff (TTx = 10, TMx = 001) eine Debug-Funktion 
hinzugekommen, die über das PCR-Register (Prozessor-Controll-Register) 
aktiviert werden kann. 


Signale: PSTO bis PST4 


Wie beim MC68040 werden hier ebenfalls einige Informationen über den 
aktuellen Prozessorstatus angezeigt. Dadurch, daß eine Leitung hinzuge- 
kommen ist, gibt es zusätzlich Informationen und eine veränderte Aufteilung. 


Signale: TA, TEA, TRA 


Die Funktion ist die gleiche wie beim MC68040. Beim MC68040 mußte man 
zur Buswiederholung die Signale TEA und TA aktivieren, was auch beim 
MC68060 möglich ist oder es wird nur mit TRA (nur MC68060) die 
Buswiederholung angefordert (Transfer-Retry-Acknowledge). 


Buszugriffssteverung: BTT, BGR, BB, BGx 


Für den Multi-Master-Betrieb wurden beim MC68060 zwei neue Signale 
eingeführt (BTT = Bus-Tenure-Termination, BGR = Bus-Grant-Relinquish). Mit 
denen eine Vereinfachung des Buszugriffs vereinfacht werden (nur bei 0,5- 
oder 0,25-facher Taktfrequenz). Es können aber auch weiterhin die alten 
Signale verwendet werden. 
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Cache-Steverung: CDIS 


Mit dem einzigen Signal CDIS kann der Cache beim MC68060 ein- bzw. 
ausgeschaltet werden (ohne Verlust des Inhalts). 


unteilbarer Zyklus: LOCK, LOCKE 


Auch hier entspricht die Funktion der Signale, die des MC68040. Allerdings 
fehlt hier der CAS2-Befehl, welcher unter anderem über das BCR-Register 
(Bus-Control-Register) emuliert werden kann. Es können unteilbare Zyklen 
über das Register erzeugt werden. 


Takteingang: CLK, CLKEN 


Der CLK-Eingang entspricht im wesentlichem dem BCLK-Eingang vom 
MC68040 (Ein-Phasen-Takt). Mit dem neuem CLKEN-Eingang kann man den 
Prozessortakt auf die Hälfte bzw. auf ein Viertel reduzieren. 


Die restlichen Signale entsprechen denen des MC68030. 


Das war jetzt nur eine kurze Zusammenfassung der Signale aller 
MC680x0-Prozessoren. Einige Signale haben in Verbindung mit 
anderen noch weitere Funktionen, auf die wir hier nicht weiter 
eingegangen sind. Es sollte sich bei der Zusammenfassung nur um 
einen Überblick der Signalfunktionen handeln und zum besseren 
Verständnis beitragen. Danach verstehen Sie die Zusammenhänge der 
nachfolgenden Abschnitte umso besser. 
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1.1.2 Die Co-Prozessoren (FPU/MMU) 


Die CPU ist das Herz eines jeden Rechners. Alle Operationen laufen 
über ihr ab. Es gibt jedoch Dinge, für die die "normale" CPU nicht 
besonders gut geeignet ist. Dieses sind zum Beispiel Fließkomma- 
operationen. Prinzipiell wären diese auch mit der CPU möglich (siehe 
mathtrans.library), allerdings nicht besonders schnell in der Ausführ- 
ung. Dafür und für andere Dinge gibt es spezielle Prozessoren, die 
nur für diese Funktionen ausgelegt sind. 


Im MC68020/30 ist für solche Prozessoren eine Schnittstelle integri- 
ert, über die sie angesteuert werden können. Für den MC68020 ist 
eine PMMU (Paged-Memory-Manegement-Unit) und eine FPU 
(Fließpunkt-Arithmetik-Prozessor) erhältlich. Die Bezeichnungen sind 
MC68851 (PMMU) und M(C68881/2 (FPU). Der MC68030 ist auch 
mit integrierter MMU erhältlich (keine EC-Version). 


Seit dem M(C68040/60 ist die Co-Prozessorschnittstelle eigentlich 
"überflüssig". Denn diese Chips haben bereits eine MMU und FPU 
integriert (nur die Voll-Versionen, nicht EC/LC-Version). Diese Ein- 
heiten verfügen aber meist über einen reduzierten Befehlssatz der 
externen Versionen. Damit die Kompatibilität trotzdem gegeben ist, 
werden die fehlenden Befehle über den Prozessor emuliert (68040er. 
library etc.) und das bei höherer Geschwindigkeit. 


Die MC68020/30/40/60-CPUs können maximal acht Co-Prozessoren 
verwalten. Welcher Prozessor angesprochen wird hängt von einer 3- 
Bit-ID im Op-Code des Befehlsword ab (Bits 9-11). Die Befehle der 
Co-Prozessoren sind speziell gekennzeichnet (F für FPU: FMove) und 
können direkt im Maschinencode mit den anderen CPU-Befehlen 
gemischt werden. Allerdings ist zu beachten, daß die Co-Prozessor- 
Befehle teilweise parallel abgearbeit werden. 
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Die FPU MC68881/2 (Fließpunkt-Einheit) 


Diese (Co-Prozessoren, wie auch die integrierten Versionen vom 
MC68040/60 erlauben die schnelle Verarbeitung von Fließpunkt- 
Operationen. Sie erfüllen den Fließpunkt-Arithmetik-Standart IEEE 
P754 und enthalten darüber hinaus noch einige Funktionen für 
trigonometrischer und transzendenter Operationen. 


Der MC68881/2 besteht im wesentlichen aus drei Blöcken: 


- Bus Interlace Unit (BIU) 
- Frecution Control Unit (FCU) 
- Microcode Control Unit (MCU) 


Beide FPUs sind pin- und funktionskompatibel. Der einzige Unter- 
schied liegt in der Verarbeitungsgeschwindigkeit. Der MC68882 
wurde intern etwas überarbeitet und kann dadurch einige Operatio- 
nen parallel ausführen, was beim MC68881 nicht möglich ist. 


In der BIU befinden sich die Schnittstellenregister, sowie das Steuer- 
und Status-Register (FPCR, FPSR). Sie ist die eigentliche Schnittstelle 
zum Hauptprozessor. 


Die ECU enthält die Register FPO bis FP7 (Fließpunkt-Anwender- 
Register, wie Datenregister DO bis D7), ein Konstanten-ROM mit 22 
Werten (pi, e, etc.) und die ALU (arithmetisch-logische-Einheit). Auch 
hier ist für die schnelle Ausführung von Schiebe-Operationen ein 67- 
Bit-Barrel-Shifter integriert. Damit kann eine Schiebefunktion in einem 
Taktzyklus ausgeführt werden. 


Die MCU kontrolliert den korekten Ablauf der Berechnungen und der 
Kommunikation untereinander. Sie besteht im wesentlichen aus 
einem Befehlsdekoder, Taktgenerator und dem Microcode für die 
Befehle. 
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Wenn Ihr Amiga eine Fließpunkt-Einheit integriert hat (duch Anschluß 
eines MC68881/2 oder MC68040/60), so ergibt sich ein erweitertes 
Registermodell. 


Bild 1.1.2. 


BITS: 79 63 31 16.15 8.7 8 
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Es sind jetzt sieben 80-Bit-Fließpunkt-Datenregister (FPO-FP7), ein 32- 
Bit-Steuer-Register (FPCR: nur 16 Bit in Funktion), ein 32-Bit-Status- 
Register (FPSR) und ein 32-Bit Instruction-Adress-Register (FPIAR) 
hinzugekommen. 


Wie die FPUs „programmiert werden, wird im Abschnitt 1.12 aus- 
führlich beschrieben. 
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Für den Anschluß des MC68881/2 an den Hauptprozessor sind alle 
notwendigen Signale für einen asynchronen Buszyklus des 
MC68020/30 vorhanden (AS, R/W, DS, DSACKO/1, CS). Asynchron 
deshalb, weil der Takt höher sein kann als beim Hauptprozessor, 
wodurch die Rechenoperationen des MC68881/2 noch schneller 
werden. 


Der MC68881/2 ist in einem Pin-Grid-Array (RC) und einem Plastic- 
Leadless-Chip-Carrier (PLCC) Gehäuse erhältlich. 


Bild 1.1.2.b 
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Über die Adreßleitungen Al bis A4 wird die Schnittstellen- 
Registerauswahl getroffen. Die Register sind immer 16- oder 32-Bit 
breit und liegen auch immer auf geraden Adressen. 


Mit der Adreßleitung AD und dem SIZE-Signal wird die 
Datenbusbreite statisch festgelegt. Beim Amiga immer 32 Bit (SIZE u. 
AO = 1). 


Die PMMU M(C68851 (Page-Mem.-Manaäg.-Unit) 


Dieser Co-Prozessor wird im Amiga eigentlich überhaupt nicht einge- 
setzt. Er kann auch nur in Verbindung mit dem MC68020 genutzt 
werden. Ab dem M(C68030 (Voll-Version) ist bereits eine PMMU in 
dem Chip enthalten. Diese integrierten Versionen enthalten einen 
stark reduzierten Befehlssatz gegenüber dem M(C68851 (MC68030 
nur noch vier Befehle, MC68040 zwei Befehle). Welche Befehle zur 
Verfügung stehen zeigt folgenden Tabelle. 


Befehl: Funktion 

PMOVE Data-Movement (MC68030) 

PVALID Parameter-Validation 

PTEST Adress-Attribute-Testing (MC680 30/40/60) 
PFLUSH invalidate ATC-Entries (MC68030/40/60) 
PFLUSHR invalidate an Entries in the Root-Pointer-Table 
PFLUSHA invalidate alle ATC-Entries 


PBcc Branch Conditionally 
PDBcc Decrement and Branch Conditionally 
PScc Set Conditionally 


PSAVE Save-State 
PLOAD Load-State (MC68030) 
PRESTORE Restore State 
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Alle PMMU-Befehle fangen mit einem "P" an. Eine Ausführliche Be- 
schreibung der Befehle für den MC68030/40/60 und deren Program- 
mierung finden Sie im Abschnitt 1.13. 


Bei einer vorhandenen PMMU wird auch hier das Registermodell 


erweitert. Welche Register hinzukommen entnehmen Sie bitte dem 
Abschnitt 1.1.1 und der folgenden Tabelle: 


PMMU-Registermodell des MC68030: 


W - (32-Bit-Translation-Control-Register) 
TT0/1 (2 x 32-Bit-Transparent-Translation-Register) 
MMUSR (16-Bit-PMMU-Status-Register) 


PMMU-Registermodell des MC68040: 


TC (16-Bit-Translation-Control-Register) 

DTTO/1 (2x32-Bit-Data-Transparent-Translation-Register) 
ITTO/1 (2x32-Bit-Instruction-Transparent-Translation-Reg.) 
MMUSR (32-Bit-PMMU-Status-Register) 


PMMU-Registermodell des MC68060: 


TC (16-Bit-Translation-Control-Register) 

DTTO/1 (2x32-Bit-Data-Transparent-Translation-Register) 
ITTO/1 (2x32-Bit-Instruction-Transparent-Translation-Reg.) 
IACRO/1 (2x32-Bit-Instruction-Access-Control-Register) 


Der MC68851 ist nur in einem Pin-Grid-Array-Gehäuse (RC) erhältlich. 
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1.1.3 Die ClAs (8520) 


Die ClAs (Complex-Interface-Adapter) sind zwei Bausteine (Chip-Bez. 
8520) die jeweils zwei Hauptaufgaben zu erfüllen haben. Einmal die 
Verbindung mit der Außenwelt über zwei 8-Bit breite Ports, und zum 
anderen die interne Zeitmessung über zwei 16-Bit und einen 24-Bit 
Timer. Für die serielle Datenübertragung enthält der Baustein noch 
einen entsprechenden Port (SP), welcher bidirektional ist. 


Funktionen der Schnittstellenbausteine CIAWB: 


- zwei 8-Bit-Parallelports (PA und PB) 

- zwei 16-Bit-Abwärtszähler (CRx, TxLO,TxHI,PxLO,PxHIl: X=A o. B) 
- ein serieller Port (SDR) 

- einen 24-Bit-Zähler (TODLO,TODMID,TODHI) 


Eingebunden werden die Bausteine über den E-Takt des MC68000 
oder ab dem MC68020 über eine Byte-Freigabe-Schaltung, welche 
mit dem PHi2-Eingang der ClAs verbunden ist. 


Im Amiga befinden sich zwei Bausteine vom Typ 8520, welche als 
CIA-A und CIA-B bezeichnet werden. Beide besitzen 16 Register, über 
die die verschiedenen Funktionen ausgelöst werden können. Die CIAA 
liegt ab Adresse $BFEOO1 und die CIA-B ab Adresse $BFDO00. Jedes 
Register ist 8-Bits breit und 256 Bytes ($100) vom vorherigen 
entfernt. 
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Bild 1.1.3.4 


Pinbeleaune des 8528 mit Sianalrichtuna 
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Ein Strich über ein Signalnamen steht für 
Low-fAkt Lv CB8-Akt lu). 


Frkläarung der wichtigsten Signale: 


PAO-PA7 = Parallelport A (8 Bit) 

PBO-PB7 Parallelport B (8 Bit) 

Vcc,GND = Spannungsversorgung 

AO-A3 = Adreßbus für die Auswahl der 16 Register 


DO-D7 = Datenbus (8-Bit) 
PHI2 = Takteingang 

IRQ = Interrupt-Signal 
2 = serieller Port 

RES = Reset-Leitung 
R/W = Read/Write-Signal 
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Was für Funktionen den Signalen beim Amiga zugeordnet werden, 
zeigt folgende Auflistung: 


CAA [Adresse $BFFOO1): 


CIAA-Pin__ Funktion 

IRQ) INT2-Eingang von Paula 

DO-D7 Bits O bis 7 des Prozessordatenbus 

AO-A3 Bits 8 bis 11 des Prozessoradreßbus (256-Byte-Abstände) 


PA7 Pin 6 vom Gameport 1 (Fire/linke Maustaste) 

PA6 Pin & vom Gameport O (Fire/linke Maustaste) 

PA5 RDY - Disk-Ready-Signal vom Diskettenlaufwerk 

PA4 TKO - Signal das Lesekopf von der Floppy auf Track Null 
PA3 WPRO - Write-Protect-Signal vom Diskettenlaufwerk 

PA2 CHNG - Disk-Change-Signal vom Diskettenlaufwerk 

PAI LED - Power-LED- u. Tiefpaßfilter-Steuerung (O=hell) 
PAO OVL - Memory-Overlay-Bit 

SP KDAT - serielle Daten von der Tastatur 

CNT KCLK - Takt der Tastaturdaten 

PBO-PB7__DATAXx - Centronics-Parallel-Interface-Daten 

PC DRDY - Centronics-Handshakesignal für Daten bereit 
FLAG ACK - Centronics-Handshakesignal für Daten übernommen 


Seite 49 


Hardwaregrundlagen Kapitel 1 


CIAB-Pin 
IRQ 
DO-D7 
AO-A3 
PA7 
PA6 
PA5 
PA4 
PA3 
PA2 
PAI 
PAO 
SP 
CNT 
PB7 
PB6 
PB5 
PB4 
PB3 
PB2 
PB] 
PBO 
FLAG 
PX 


M-B (Adresse $BFDOOO): 


Funktion 

INT6-Eingang von Paula 

Bits 8 bis 15 des Prozessordatenbus 

Bits 8 bis 11 des Prozessoradreßbus (256-Byte-Abstände) 
DIR - serielle Schnittstelle: DTR-Signal 

RTS - serielle Schnittstelle: RTS-Signal 

CD - serielle Schnittstelle: CD-Signal 

CTS - serielle Schnittstelle: CTS-Signal 

DSR - serielle Schnittstelle: DSR-Signal 

SEL - SELECT-Signal zur Centronics-Schnittstelle 
POUT - PAPER-OUT-Signal von der Centronics-Schnittstelle 
BUSY - BUSY-Signal von der Centronics-Schnittstelle 
wie PAO 

wie PA] 

MIR - MOTOR-Signal zum Diskettenlaufwerk 

SL3 - Select-Drive3-Signal 

SL2 - Select-Drive2-Signal 

SL1 - Select-Drive 1-Signal 

SLO - Select-DriveO-Signal (internes Laufwerk) 

SIDE - Side-Select-Signal zum Diskettenlaufwerk 
DIR - Direction-Signal zum Diskettenlaufwerk 

STEP - STEP-Signal für Schreib-/Lesekopf der Floppy 
INDEX - Index-Signal vom Diskettenlaufwerk 
unbenutzt 


Wie bereits schon erwähnt besitzt jede CIA jeweils 16 Register. Die 
Funktionen sind natürlich zwischen CIAA und CIAB unterschiedlich. 
Das zeigen schon die oben aufgeführten Signalverbindungen. Welche 
Funktionen die Register im Einzelnen besitzen und über welche 
Adresse das jeweilige Register ansprechbar ist, zeigt die folgende 


Tabelle: 
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CHA A (ungerade Adressen); 
Name Adr. Funktion 
PRA BFE001 Ein- Ausgaberegister A 
PRB BFE101 Ein- Ausgaberegister B (Centronics Parallelport) 
DDRA BFE201 Datenrichtungsreg. für PRA (Normal = Wert 3) 
DDRB BFE301 Datenrichtungsreg. für PRB 
TALO BFE401 Timer A Bits 0 bis 7 (Frequenz = 1/10 CPU-Takt) 
TAHI BFE501 Timer A Bits 8 bis 15 
TBLO BFE601 Timer B Bits 0 bis 7 (Frequenz = 1/10 CPU-Takt) 
TBHI BFE701 Timer B Bits 8 bis 15 
TODLO BFE801 VSync-Zähler Bits 0 - 7 (50 Hz = PAL, 60 = NTSC) 
TODMID BFE901 VSync-Zähler Bits 8 bis 15 
TODHI BFEA0O1 VSync-Zähler Bits 16 bis 23 
--..-- BFEBOl unbenutzt 
SDR BFECO1 serielles Datenregister (Tastaturverbindung) 
ICR BFEDO1 Interrupt-Kontrollregister 
CRA BFEE01 Kontrollregister A 
CRB BFEF01 Kontrollregister B 
Die CIAA Kann einen Interrupt der Stufe Z£ (INTZ) erzeugen. 
CHA B (gerade Adcressen): 
Name _ Adr. Funktion 
PRA BFD000 Ein- Ausgaberegister A 
PRB BFD100 Ein- Ausgaberegister B (Drive-Motor) 
DDRA BFD200 Datenrichtungsreg. für PRA (Normal = Wert 192) 
DDRB BFD300 Datenrichtungsreg. für PRB (Normmal = Wert 255) 
TALO BFD400 Timer A Bits 0 bis 7 (Frequenz = 1/10 CPU-Takt) 
TAHI BFD500 Timer A Bits 8 bis 15 
TBLO BFD600 Timer B Bits 0 bis 7 (Frequenz = 1/10 CPU-Takt) 
TBHI BFD700 Timer B Bits 8 bis 15 
TODLO BFD800 HSync-Zähler Bits 0 - 7 (Zeilenfrequenz) 


TODMID BFD900 


TODHI BFDAO0O0 
— BFDBOO 
SDR BFDCOO 
ICR BFDDOO 
CRA BFDEOO 
CRB BFDFOO 


HSync-Zähler 
HSync-Zähler 
unbenutzt 
serielles Datenregister (unbenutzt) 
Interrupt-Kontrollregister 
Kontrollregister A 
Kontrollregister B 


Bits 8 bis 15 
Bits 16 bis 23 


(Normal bei PAL =>) 
(15625/sec) 


Die CIAB kann einen Interrupt der Stufe 6 (INT6) erzeugen, 
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Kommen wir jetzt zu den einzelnen Funktionen der Register: 


Parallele Datenausgabe über die CIA: 


Für die parallele Datenausgabe stehen uns zwei 8-Bit-Ports zur 
Verfügung und das bei jeder CIA. Jedes einzelne Bit dieser vier Ports 
läßt sich als Ausgang oder als Eingang einstellen. Da aber bestimmte 
Leitungen der Ports schon fest verdrahtet sind, können wir nicht 
mehr auf alle Bits (Ports) frei zugreifen. 


Für die parallele Verarbeitung existieren die Register PRA, PRB, 
DDRA und DDRB (für jede CIA). Die Register PRA und PRB enthalten 
die Portdaten für PortA bzw. PortB. Wie jetzt ein Bit in einem Port 
geschaltet ist (Eingang oder Ausgang), hängt vom eingestellten Wert 
im dazugehörigen Portdatenrichtungsregister ab (DDRA oder DDRB). 
Ein gesetztes Bit bedeutet, daß die entsprechende Portleitung als 
Ausgang geschaltet ist, ein gelöschtes Bit steht für einen Eingang. 


Bitbelegung der einzelnen Ports und Richtung: 


Register: CIAA-PRA (Portdatenregister A von CIAA) 
Adresse: $BFEOO! 

Bitbelegung: 
Bit_Name _ Funktion 
7 FIRI Ist Null, wenn linke Maustaste oder Feuerknopf von Port] gedrückt 
6  FIRO Ist Null, wenn linke Maustaste oder Feuerknopf von PortO gedrückt 
5 RDY Disk-Ready-Signal vom Diskettenlaufwerk 
4 TKO Schreib-/Lesekopf vom Diskettenlaufwerk auf Track O 
3 WPRO Signal für Diskette schreibgeschützt 
2 CHNG  Disk-Change-Signal vom Diskettenlaufwerk 
i 21820 Steuerung der Power-LED und des Tiefpaßfilters (0 = hell, 1 = dunkel) 
0 OVL Memory-Overlay-Bit (nicht verändern) 


dazugehöriges Portdatenrichtungsregister: 
Register: CIAA-DDRA (Richtung der Portsignale A von CIAA) 


Adresse: $BFE2O1 
Wert: %00000011 ($03) - nicht ändern 
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Durch diese feste Zuordnung von Signalen sind für diesen Port die 
Richtungen schon vorgegeben. Dieser Wert sollte auch nicht geändert 
werden (DDRA = $03). 


Möchte man zum Beispiel die linke Maustaste in PortO abfragen, so 
genügen folgende Assemblerzeilen: 


btst #6, $bfe001 ; linke Maustaste abfragen 
beq LinkeMaus 


Register: CIAA-PRB (Portdatenregister B von CIAA) 
Adresse: $BFE1O1 

Bitbelegung: 
Bit_Name _ Funktion 
7 PB7 Diese acht Bits sind direkt mit den Datenleitungen der Cenctronics- 
6  PB6 Schnittstelle verbunden. Alle Bits sind im Normalbetrieb als Ausgang 
> PB5 geschaltet. Hierüber können dann direkt ASCII-Codes an den Drucker 
4  PB4 geschickt werden. Der Port läßt sich aber auch beliebig anders ver- 
3 PB3 wenden. Sie können über das dazugehörige DDRB-Register jedes ein- 
2  PB2 zelne Bit als Ausgang oder Eingang definieren. 
1 PB] 
0  PBO 


dazugehöriges Portdatenrichtungsregister: 
Register: CIAA-DDRB (Richtung der Portsignale B von CIAA) 


Adresse: $BFE3O1 
Wert: beliebig wählbar (normal für Drucker = $FF) 
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Register: CIAB-PRA (Portdatenregister A von CIAB) 
Adrese: $BFDOOO 


Bitbelegung: 


Name _ _ Funktion 

DTR Serielle Schnittstelle: Data-Terminal-Ready-Signal 
RTS Serielle Schnittstelle: Request to Send-Signal 

CD Serielle Schnittstelle: Carrier-Detect-Signal 

cTs Serielle Schnittstelle: Clear to Send-Signal 


DSR Serielle Schnittstelle: Data-Set-Ready-Signal 

SEL Centronics-Schnittst.: Select-Signal (1 = Drucker Online, 0 = Offline) 
POUT _ Centronics-Schnittst,; Paper-Out-Signal (kein Papier vorhanden) 

BUSY _ Centronics-Schnittst.: Busy-Signal (0 = Druckerdatenpuffer ist voll) 


o-nweuaoanlß 


dazugehöriges Portdatenrichtungsregister: 


Register: (CIAB-DDRA (Richtung der Portsignale A von CIAB) 
Adrese: $BFD200 
Wert: % 11000000 ($CO) - nicht ändern 


——— | ———— nn nn nm nn nn u nm nn nnn nn nn nn nm — nn nn nn nme sn nn ———— ln — nn n nun nn nn —— nn nn on mn — nun m 


Register: CIAB-PRB (Portdatenregister B von CIAB) 
Adrese: $BFD100 


Bitbelegung: 


Name _ Funktion 

MTR Motor-Signal zum Diskettenlaufwerk 

SEL3 Drive-Select für Diskettenlaufwerk 3 

SEL2 Drive-Select für Diskettenlaufwerk 2 

SELI Drive-Select für Diskettenlaufwerk 1 

SELO Drive-Select für Diskettenlaufwerk O (intern) 
SIDE Side-Signal für Laufwerk (Oben oder Unten) 

DIR Richtungssignal für Schreib-/Lesekopf der Floppy 
SIEP STEP-Signal für Diskettenlaufwerk 


o-nweuwuonß 


dazugehöriges Portdatenrichtungsregister: 
Register: CIAB-DDRB (Richtung der Portsignale B von CIAB) 


Adrese: $BFD300 
Wert: %11111111 ($FF) - nicht ändern 
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Für die Druckeransteuerung setzen wir das DDRB-Register der CIAA 
($BFE3O1) auf den Wert $FF. Damit sind alle Bits des Portdatenre- 
gisters DRB ($BFE101) als Ausgang geschaltet. Über das SEL-Bit im 
CIAB-PRA-Register ($BFDO00) fragen wir ab, ob der Drucker online 
ist, ansonsten könnten wir keine Daten an den Drucker senden. 
Danach testen wir noch das POUT und BUSY-Bit. Ist Papier vorhanden 
(POUT = 0) und der Drucker aufnahmebereit für Daten (BUSY = 1), 
können wir diese dem Drucker übermitteln. 


Dazu müssen wir die Daten in das PRB-Register schreiben ($BFE101) 
und die Strobe-Leitung des Druckers, welche mit dem PC-Pin von 
CIAA verbunden ist, solange auf Null setzen (Signalisiert: gültige 
Daten liegen an), bis der Drucker uns das Acknowledge-Signal sendet 
(Daten übernommen). Letzteres ist mit der FLAG-Leitung von CIAA 
verbunden. 


Die Strobe-Leitung des Druckers geht automatisch beim Schreiben der 
Daten in das PRB-Register auf Null. Sobald der Drucker die Daten in 
seinen Puffer übernommen hat, aktiviert er das Acknowledge-Signal 
für mindestens 1 Microsekunde und löst dadurch einen FLAG- 
Interrupt aus (Bit 4 im CIAA-ICR-Register = $BFECO1). 


Serielle Datenausgabe über die CIA: 


Für die serielle Ausgabe bzw. Eingabe von Daten über die CIA stehen 
einem die SP-Register zur Auswahl. Das SP-Register der CIAA wird 
schon für den Empfang der Tastencodes benötigt. Das zweite SP- 
Register (CIAB = $BFDBOO) ist unbenutzt und steht frei zur 
Programmierung. 


Mit dem SPMode-Bit (Bit 6) im CIAB-CRA-Register kann man die 


Datenrichtung festlegen. Ist dieses Bit O so ist der serielle Port auf 
Eingabe und bei 1 auf Ausgabe geschaltet. 
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Der serielle Port besteht aus dem eben schon erwähnten SP-Register 
und einem internen Schieberegister. Ist der Port auf Eingabe gesetzt, 
so werden die seriellen Daten an der SP-Leitung der CIAB mit jeder 
positiven Flanke der CNT-Leitung (CIAB) in das interne Schieberegister 
geschoben. Nach acht CNT-Impulsen wird der Wert in das SP-Register 
geschrieben ($BFDBOO) und ein Interrupt ausgelöst. Dabei wird das 
SP-Bit (Bit 3) im CIAB-ICR-Register ($BFDCOO) gesetzt. Wird der Wert 
ausgelesen, können wieder Daten in das SP-Register kopiert und ein 
Interrupt ausgelöst werden. 


Ist der serielle Port auf Ausgabe programmiert, bestimmt die Unter- 
laufrate von TimerA (Continuous-Mode) die Geschwindigkeit der 
Übertragung. Die Übertragung beginnt, sobald das erste Datenbyte 
in das SP-Register (BFDBOO) geschrieben wurde. Danach überträgt 
die CIAB den Wert in das interne Schieberegister. Die einzelnen 
Datenbits, angefangen mit dem MSB, erscheinen jetzt mit der halben 
Unterlaufrate des Timers A (CIAB - Continuous-Mode) an der SP- 
Leitung. An der CNT-Leitung von CIAB liegt der Takt des Timers A. 
Die Leitung wechselt ihren Pegel bei jedem Unterlauf des Timers, so 
daß bei jeder negativen Flanke an der CNT-Leitung das nächste Bit 
an der SP-Leitung erscheint. Wurden alle acht Bits rausgeschoben, 
wird auch hier ein Interrupt ausgelöst (SP-Bit im ICR-Register wird 
gesetzt). Der Interrupt signalisiert, daß jetzt neue Daten in das SP- 
Register ($BFDBOO) geschrieben werden können. 


Für die serielle Datenübertragung über die RS232-Schnittstelle gibt es 
spezielle UART-Register (SERPER, SERDATR, ADKCONR). Darüber läßt 
sich zum Beispiel leicht ein Modem betreiben. Der serielle Port der 
CIAB wird im Amiga nicht benutzt. Außer die Bits 3 bis 7 im CIAB- 
PRA-Register ($BFDOOO), welche Auskunft über einige Signale der 
RS232-Schnittstelle geben. 
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Jede CIA verfügt über zwei 16-Bits-Abwärtszähler (Timer A und B) 
und einen 24-Bit-Vorwärtszähler (Event-Counter bzw. "TOD"). 
Kommen wir zuerst zu den 16-Bit-Timern. Jeder dieser Timer kann 
von einem definierten Anfangswert bis auf Null herunterzählen. Die 
Anfangswerte werden in folgende Register geschrieben: 


Adr N i 

SBFE401 CIAA-TALO Low-Byte von TimerA für CIAA (Bits 7-0) 
$SBFE501 CIAA-TAHI Hi-Byte von TimerA für CIAA (Bits 15-8) 
SBFE601 CIAA-TBLO Low-Byte von TimerB für CIAA (Bits 7-0) 
SBFE701 CIAA-TBHI Hi-Byte von TimerB für CIAA (Bits 15-8) 
SBFD400 CIAB-TALO Low-Byte von TimerA für CIAB (Bits 7-0) 
$SBFD500 CIAB-TAHI Hi-Byte von TimerA für CIAB (Bits 15-8) 
SBFD600 CIAB-TBLO Low-Byte von TimerB für CIAB (Bits 7-0) 
SBFD700 CIAB-TBHI Hi-Byte von TimerB für CIAB (Bits 15-8) 


Wird ein Wert in einen der Timer geschrieben, so wird es in ein 
interenes Latch zwischengespeichert. Von dort gelangt der Wert in 
ein dazugehöriges internes Zählregister (16-Bit). Das Zählregister wird 
solange heruntergezählt, bis ein Unterlauf auftritt (bei O - 1). Ist das 
der Fall, so wird der Zähler mit dem Wert aus dem internen Latch 
wieder auf den Anfangszustand gesetzt und der Vorgang läuft erneut 
ab. 


Um den aktuellen Wert aus einen der Timer zu lesen, muß dieser 
entweder angehalten werden (über dazugehöriges Kontrollreg.) oder 
man liest erst das Hi-Byte, danach das Lo-Byte und anschließend 
nochmal das Hi-Byte. Sind beide Hi-Bytes gleich, so ist der gelesene 
Zählerstand korrekt. 
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Beispiel: Lesen des Timers A von CIAA: 


ReadTimerA: 
move.b $bfe501,dO ; Hi-Byte Timer A von CIAA lesen 
move.b $bfe401,d1 ; Lo-Byte Timer A von CIAA lesen 
move.b $bfe501,d0 ; nochmal Hi-Byte Timer A lesen 
cmp.b dO,dI ; Hi-Bytes vergleichen 
bne ReadTimerA ; wenn ungleich, dann nochmal lesen 
Isl.w  #8,dO ; Hi-Byte ab Bit 8 
move.b d1,dO ; Lo- und Hi-Byte verbinden 


;---- DO enthält jetzt den aktuellen Timerwert ---- 


Wie wir den Timer anhalten bzw. starten oder die Taktfrequenz und 
noch einiges mehr einstellen können, bestimmen die zu jedem Timer 
gehörenden Kontrollregister. Für Timer A ist es das CRA- (Control- 
Register A) und für Timer B das CRB-Register (Control-Register B). 


Register: CRA (Control-Register-A für Timer A) 
Adresse:  CIAA: $BFEEOI CIAB: $BFDEOO 


Bitbelegung: 


Bit Name Funktion 
7 ---- unbelegt 
6 SPMODE Richtung für SP-Register (0O=Eingang, 1=Ausgang) 
5 INMODE Takt für TimerA (0=EClock => PAL:709,379 KHz = 1,41 
microsekunden; NTSC = 715,909 KHz) oder 
l=zexterner Takt über CNT-Leitung, bei CIAA ist hier 
der Tastaturtakt; damit bleibt INMODE immer = 0) 
4 LOAD 1 = TimerA laden (Latchwert ins Zählreg. übertragen) 
dieses Bit geht automatisch nach dem Laden wieder auf 
Null zurück (STROBE) 
3 RUNMODE O=Continuous (TimerA fängt immer wieder von vorne an) 
l1=Oneshot (TimerA macht nur einen Durchgang) 
2 OUTMODE Ausgabeart für "PBon"=an (Unterlauf TimerA an PB6): 
O=Pulse (an PB6 kommt ein Impuls für einen Takt) 
1=-Toggle (an PB6 wechselt die Flanke; Start bei High) 
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bei Unterlauf von TimerA kann dieser an der PB6- 
Leitung angezeigt werden (siehe OUTMODE). 

O=aus (Unterlauf nicht an PB6 ausgeben) 

1=an (Unterlauf an PB6 ausgeben) 

1 = TimerA starten 

0 = TimerA anhalten 


CRB (Control-Register-B für Timer B) 
CIAA: $BFEFO1 CIAB: $BFDFOO 


Bitbelegung: 


Bit Name Funktion 


7 ALARM 


6 INMODE 
5 INMODE 


4 LOAD 


3 RUNMODE 


2 OUTMODE 


1 PBON 


0 START 


Alarm-Wert für Event-Counter setzen 

l=jetzt kann ein Alarm-Wert in die TODxx-Register 
geschrieben werden 

0=Alarmfunktion für Event-Counter ausschalten 

Takt für TimerB 

00=EClock => PAL:709,379 KHz 

Ol=externer Takt über CNT-Leitung (Pin 12 des 
Centronics-Port) 

10=TimerB wird bei jedem Unterlauf von TimerA um 
einen erniedrigt 

l1=wie 10, nur das zusätzlich die CNT-Leitung High 
sein muß 

1 = TimerB laden (Latchwert ins Zählreg. übertragen) 
dieses Bit geht automatisch nach dem Laden wieder auf 
Null zurück (STROBE) 

O=Continuous (TimerB fängt immer wieder von vorne an) 
1=-Oneshot (TimerB macht nur einen Durchgang) 
Ausgabeart für "PBon"=an (Unterlauf TimerB an PB7): 
0=Pulse (an PB7 kommt ein Impuls für einen Takt) 
1=-Toggle (an PB7 wechselt die Flanke; Start bei High) 
bei Unterlauf von Timer B kann dieser an der PB7- 
Leitung angezeigt werden (siehe OUTMODE) . 

O=aus (Unterlauf nicht an PB7 ausgeben) 

l=an (Unterlauf an PB7 ausgeben) 

1 = TimerB starten 

0 = TimerB anhalten 
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Gestartet bzw. gestoppt werden kann ein Timer über das START-Bit. 
Wird der Timer gestartet, so bestimmt das RUNMODE-Bit, ob der 
Timer nur einmal bis auf Null erniedrigt wird (Oneshot) oder ob 
dieser nach einem Unterlauf wieder von vorne beginnt (Conitnuous). 
Beim ONESHOT-Modus wird das START-Bit am Ende (Unterlauf) auf 
Null zurückgesetzt. Die Zählfrequenz wird dabei von den INMODE- 
Bits festgelegt (siehe oben). Normal laufen die Timer im EClock-Takt 
(INMODE=00). 


Die Unterläufe der Timer werden im ICR-Register (Interrupt-Control- 
Register) registriert. Für TimerA wird das TA-Bit (Bit O) und für 
TimerB das TB-Bit (Bit 1) bei einem Unterlauf gesetzt. Es besteht 
zusätzlich die Möglichkeit, die Unterläufe auf den Port B auszugeben. 
Dazu muß das PBON-Bit im entsprechenden CRA- bzw. CRB-Register 
gesetzt werden. Jetzt erscheint jeder Unterlauf, in Abhängigkeit des 
OUTMODE-Bits, auf der PB6-Leitung für TimerA bzw. auf der PB7- 
Leitung für Timerß. 


Kommen wir jetzt zu den 24-Bit-Vorwärtszählern (Event-Counter). 
Diese haben einen \Wertebereich von O bis $FFFFFF. Der Event- 
Counter der CIAA erhöht den Zähler alle 20 ms (50 Hz) bei einem 
PAL-Amiga (Europa) bzw. alle 16,666.. ms (60 Hz) bei einem NTSC- 
Amiga (USA). Der Event-Counter der CIAB wird in Abhängigkeit der 
horizontalen Sync-Impulse (PAL-/NTSC-Zeilenfrequenz) erhöht. Beim 
normalen PAL-HIRES-Amiga sind dies 15625 Schritte pro Sekunde (64 
microsekunden). Erreicht der Zähler den Endwert ($FFFFFF), springt er 
automatisch wieder auf Null und zählt weiter. 


Bei jedem Schreibzugriff hält der Zähler automatisch an und läuft erst 
dann weiter, wenn der letzte Wert ins LSB-Register (TODLO) ge- 
schrieben wurde. Also sollte man immer darauf achten, daß zuletzt 
das LSB (Bits 0-7) des 24-Bit-Wertes gesetzt wird. 


Bei einem Lesezugriff muß mit dem MSB-Wert (TODHI) begonnen 


werden. Denn sobald das MSB (Bits 23-16) ausgelesen wurde, wird 
der aktuelle Zählerstand (alle 24-Bit) in einem Latch zwischenge- 
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speichert und der Zähler kann ohne Fehler weiter zählen. Erst 
nachdem das LSB (TODLO) gelesen wurde, wird das Latch abge- 
schaltet. 


Auch die Event-Counter können einen Interrupt auslösen, voraus- 
gesetzt: zuvor wurde ein Alarm-Wert gesetzt. Dafür muß man das 
Alarm-Bit (Bit 7) in das CRB-Register setzen und danach den Alarm- 
Wert, bei dem der Zähler einen Interrupt auslösen soll. Hat der 
Zähler den Alarm-Wert erreicht, so wird das Bit 2 im ICR-Register 
gesetzt. 


Interru ung Ü die CJA: 


Die beiden ClAs sind in der Lage Interrutps auszulösen. Auf die 
möglichen Interrupt-Ereignisse sind wir ja bereits eingegangen. Zur 
Erinnerung hier noch einmal alle möglichen Interruptquellen: 


1. Unterlauf von TimerA (TA-Bit im ICR-Register) 

2. Unterlauf von TimerB (TB-Bit im ICR-Register) 

3. Event-Counter = Alarm-Wert (Alarm-Bit im ICR-Register) 

4. Schieberegister d. SP-Registers ist voll bzw. leer (SP-Bit im ICR-Register) 

5. Centronics-Port: negative Flanke am FLAG-Eingang (FLAG-Bit im ICR-Register) 


Das Interrupt-Control-Register (ICR) kann zum einen als Datenregister 
(Lesezugriff) und andererseits einmal als Maskenregister (Schreibzu- 
griff) genutzt werden. Die Belegung ist bis auf Bit 7 identisch. Beim 
Lesen zeigt es an, daß mindestens eine der möglichen Interrupt- 
quellen aufgetreten ist (IR) und beim Schreiben dient es zum 
Setzen/Löschen von Interrupt-quellen (S/C). 
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Register: ICR (Interrupt-Control-Register) 
Adresse: CIAA: $BFECO| CIAB: $BFDCOO 


Bitbelegung: 


Bit Name Funktion 

7 IR-S/C Wird das Register gelesen ist IR zuständig. Wenn ein 
Interrupt auftritt, wird dieses und das IRQ-Bit der 
Quelle gesetzt. 
Wird das Register beschrieben (Maske setzten), ist 
S/C zuständig. Möchte man einen Interrupt erlauben, 
so muß dieses Bit und das gewünschte IRQ-Bit gesetzt 
werden. Möchte man einen Interrupt verbieten, so muß 
dieses Bit gelöscht und das gewünschte IRQ-Bit ge- 
setzt werden. Alle anderen Bits bleiben immer unbe- 


einflußt. 
6 _ ----- Keine Funktion (beim Lesen = 0, Schreiben = egal) 
wie Bit 6 
4 ----- Lesen: 1 wenn Flag-Interrupt aufgetreten ist 


Schreiben: 1 wenn Flag-IRQ gesetzt bzw. gelöscht 
werden soll (Abhängig vob Bit7 - S/C) 


3 ----- SP-Interrupt (serieller Port). Funktion wie Bit 4 
2 --- Alarm-Interrupt. Funktion wie Bit 4 

l_ ----- TB-IRQ (Unterlauf TimerB). Funktion wie Bit 4. 

0 ----- TA-IRQ (Unterlauf TimerA). Funktion wie Bit 4. 


Zum Abschluß noch ein Beispiel für die Timerprogrammierung. Es 
demonstriert die Programmierung des TimersA von CIAA. Dieser wird 
bei 50 Hz im Continous-Mode betrieben. Normalerweise wird dieser 
Timer für die Tastatursteuerung vom Betriebssystem genutzt. 
Deswegen ist die Routine mit Vorsicht zu genießen. Außerdem wird 
das Multitasking deaktiviert. Eine bessere Methode die Timer zu 
programmieren, wird zum Beispiel im Kapitel 14 (LowLevel-Library) 
beschrieben. 
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‚-—- TimerA von CIAA im 50Hz-Takt laufen lassen --- 
;—- Power-LED in diesem Takt an/ausschalten 


lea $dff000,a6 ; Custom-Basisadr. 
move.w $1C(a6),Old INTENA ; INTENA-Reg. retten 
move.w $2(a6),Old DMACON ; DMACON-Reg. retten 
move.w #%$7FFF,$9a(a6) ; IRQs verbieten 
move.l $68,0ld Ebene2 ; IRQ-Ebene 2 retten 
move.| #Ports,$68 ; eigene IRQ-Routine 
move.w #$7FFF,$9C(a6) ; Clear request (IRQs) 
move.w #%c008,$9a(a6) ; CIAA-IRQ) erlauben 


--- TimerA CIA_A initialisieren und starten --- 


lea $bfe001,a5 ; CIAA-Basisadresse 
move.b $400(a5),Old CIAATALO ; alten Timerwert retten 
move.b $500(a5),Old CIAATAHI ; (nicht ganz korekt) 
move.b $e00(a5),Old CIAACRA ; alten CRA-Wert retten 
move.b $d00(a5),Old CIAAICR ; alten ICR-Wert retten 


move.b $e00(a5),dO ; CIAA: Controll-RegisterA lesen 
and.b #%11000000,d0 ; Bit 6/7 ausmaskieren 

or.b #%00000000,d0 ; Bit 3 (One-Shot-Mode) 
move.b dO,$e00(a5) ; CIAA: Controll-RegisterA laden 


move.b #%01111110,$d00(85) ; CIAA: alle IRQs verbieten im ICR 
move.b #%10000001,$d00(a5) ; CIAA: nur TimerA-IRQ erlauben 


an Timerspeed setzen (50Hz) --- 


MOVE.w #14185,D7 ; Takt = 50 Hz (20ms/1,41microsek.) 
MOVE.B D7,$400(A5) ; CIAATALO setzen 

LSR.W #8,D7 

MOVE.B D7,$500(A5) ; CIAA_TAHI setzen 

bset.b #0,$e00(a5) ;, CIAA: TimerA starten 


;- auf linke Maustaste warten --- 


Wait: 


btst #6,$bfe00 1 
bne Wait 


- Programm beenden --- 


lea $dff000,a6 
move.w #$7FFF,$9a(a6) ; IRQs verbieten 
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lea $bfe001,a5 ; CIAA-Basisadresse 
move.b Old CIAATALO,$400(a5) 

move.b Old CIAATAHI,$500(a5) 

move.b Old CIAACRA, $e00(a5) 

move.b Old CIAAICR,dO 

or.b #% 10000000,d0 

move.b dO0,$d00(a5) ; alte IRQs erlauben 
move.|l Old Ebene2,$68 ; alten IRQ-Routine setzen 
move.w Old INTENA,DO 

Or.W #$C000,DO 

move.w #$7FFF,$9c(a6) 

move.w DO,$9a(a6) 

rts 


;—- Port-IRQ-Routine --- 
Ports: 


move.w #$8,$dff09c ; Interrupt zurücksetzen 
move.| d2,-(sp) ; Register retten (hier nur D2) 


move.b $bfed01,d2 
btst #0,d2 ; TimerA IRQ ? 
beq Ports Taste 


bchg #1,$bfe001 ; Power-LED an/aus 

jsr mt music ; z.B. Musik abspielen 
Ports Taste: 

btst #3,d2 ; SP-IRQ (Tastatur) ? 


beq End Ports 
Si hier evtl. Tastenwert holen --- 


End Ports: 


move.| (sp)+ ‚d2 ; Register zurückholen 
rte 

Old INTENA: dc.w O 

Old DMACON: dc.w O 

Old Ebene2: dc.! 0 

Old CIAATALO: dc.w O 

Old CIAATAHI: dc.w O 

Old CIAACRA: dc.w O 

Old CIAAICR: dc.w O 
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1.1.4 Die Customchips 


Im Amiga ist nicht nur die CPU (MC680x0) für die hervorragenden 
Leistungen verantwortlich. Zudem wäre auch ein MC680x0-Prozessor 
überfordert, wenn er hochauflösende Grafik in "beliebiger" Farbtiefe 
darstellen sollte, Musik in 8-Bit-Qualität abspielen, auf das Disketten- 
laufwerk zugreifen, zusätzlich eine Animation berechnen würde und 
das alles "gleichzeitig". Dafür wurden spezielle Chips entwickelt 
(Custom-Chips), die jeweils für bestimmte Aufgaben zuständig sind 
und unabhängig vom Prozessor arbeiten. 


Diese Chips wurden bei den alten Amiga-Modellen (500/600/2000/ 
3000) mit Agnus, Denise und Paula bezeichnet. In den neuen Amigas 
(1200/4000) wurden Agnus und Denise durch Alice und Lisa ersetzt. 
Die Aufgaben verteilen sich dabei wie folgt: 


1) AGNUS / ALICE (Blitter, Copper) 

Wird hauptsächlich für die Verschiebung von Daten innerhalb des 
Speichers benutzt bzw. für die Co- und Decodierung von Disketten- 
informationen. Dieses geschieht in einer unwahrscheinlichen Ge- 
schwindigkeit. 


2) DENISE / ISA 


Ist für die Bilddarstellung zuständig. Sendet vor allen die Pixel- 
informationen aus dem Speicher zum RGB-Ausgang. 


3) PAULA 


Vor allem für Ein- und Ausgaben, wie Diskettenoperationen und 
Musik zuständig. 
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Es werden drei Arten von Custom-Chips unterschieden. Einmal die 
OCS-Bausteine (Agnus, Denise, Paula), welche in den ersten Amiga- 
Modellen eingesetzt wurden (Old-Chip-Set). Danach kommen die ECS- 
Bausteine (Agnus, Denise, Paula), welche einige Verbesserungen 
enthalten (höhere und frei programmierbare Auflösungen). ECS steht 
für Enhanced-Chip-Set (Erweiterter-Baustein-Satz.. Den Abschluß 
bildete das AA-Chip-Set (Alice, Lisa, Paula). Diese Bausteine wurden 
nochmals überarbeitet. Die Chips können jetzt mehr Farben, 
Auflösungen etc. erzeugen und die Performance wurde auch um 
einiges angehoben. Als einziger von den drei Custom-Chips enthält 
Paula immer noch den gleichen Aufbau. 


Hier eine kleine Auflistung der bisherigen Amiga-Modelle mit ein 
paar Informationen: 


Basis | OCS Amiga | ECS-Amiga | AA-Amiga 
Modell | 500/1000/2000 | 500plus/600/3000 | 1200/4000 
Farben | 32/4096 | 32/4096 | 256/16777216 
Sound | 4-Kanäle stereo | 4-Kanäle stereo | 4-Kanäle stereo 
Prozessor| 68000 | 68000/30 | 68020/30/40 
Takt (MHz) | 7 | 7/16/25 | 14/25/25 
Chip-Set | Agnus, Denise | ECS-Agnus, ECS- | Alice, Lisa, 

| Paula | Denise, Paula | Paula 
Chip-RAM | 512 KByte (256) | 512/1024/2048 K | 2048 KByte 


Die verschiedenen Amiga-Modelle sind alle von der Hardware her 
100%ig Aufwärtskompatibel. Das einige Programme auf neueren 
Modellen nicht ihren Dienst verrichten liegt daran, daß unerlaubte 
Hardware-Tricks verwendet wurden oder, daß man sich nicht an den 
offiziellen Richtlinien von Commodore gehalten hat. Zudem kann 
natürlich kein Programm auf älteren Modellen funktionieren, wenn 
spezielle Eigenschaften angesprochen werden, welche nur die 
neueren Modelle besitzen. 
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Achtung! - Es wurde schon an einem neuen Chip-Set zu Commodores 
Zeiten gearbeitet, das die Bezeichnung Triple-A-Chip-Set (AAA) tragen 
sollte. Dieses sollte volle 24-Bit Grafiken darstellen und 16 Bit statt 8 
Bit Samples erzeugen können. Allerdings soll dieses Chip-Set, laut 
damals Commodore, nicht mehr kompatibel zum AA-Chip-Set sein. In 
wieweit Amiga-Technologies diese Entwicklung voran treiben wird, 
bleibt abzuwarten. Gerade im Zeitalter der RISC-Prozessoren sollte 
man der Entwicklung nicht nachhinken. Wie es aussieht soll 1996 
auch ein Amiga mit RISC-Prozessor erscheinen und das mit einem 
abwärtskompatiblen Betriebssystem. Bleibt nur zu hoffen, daß die 
Custom-Chips nochmals gründlich überarbeitet werden, besonders im 
Bezug auf die Taktfrequenz. Doch genug der Träumereien, zurück zu 
den jetzigen Custom-Chips. 


Wie wir aus dem Bild 1.1 ersehen können, sind die Custom-Chips 
durch einen Adress- und Datenpuffer von der CPU, den ClIAs, dem 
Kickstart etc. getrennt. Dadurch wird die CPU nicht von den Custom- 
Chips gebremst, wenn diese auf den Speicher zugreifen. Das Ganze 
hat allerdings einen Hacken. Durch die Architektur der Custom-Chips 
können diese nur auf maximal 2 MByte RAM (CHIP-RAM) zugreifen. 
Zusätzlich wird noch sogenanntes FAST-RAM benötigt, worauf nur der 
Prozessor zugreifen kann, damit die beiden Einheiten (CPU/Custom- 
Chip) getrennt arbeiten können. In der Grundausstattung jeden 
Amigas befindet sich in der Regel nur CHIP-RAM, das sich dann die 
CPU mit den Custom-Chips teilen muß, was zu Geschwindigkeitsein- 
bußen führt. 


Die Custom-Chips sind untereinander mit einem Register-Adress-Bus 
verbunden. Als Verbindung zum CHIP-RAM-Adreß-Bus dient der 
Agnus- (Alice-) Chip. Er besitzt einen DMA-Controller und kann 
dadurch selbständig auf den Speicher zugreifen. Der Register-Adreß- 
Bus hat acht Leitungen und kann damit 256 verschiedene Register 
ansteuern. Die Register sind über die drei Chips verteilt. Teilweise 
befindet sich ein Register in mehreren Chips, weil der Wert mehrmals 
benötigt wird. Ein Register kann nur beschrieben oder gelesen 
werden. Welcher Zugriff erlaubt ist, ist fest definiert. 
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Das AA-Chip-Set der neuen Amigas (1200/4000) verdankt seine 
Leistungsfähigkeit einem 32-Bit-Datenbus der Custom-Chips LISA und 
ALICE, sowie einem neuem BUS-Management inkl. Datenpufferung 
für die Videoinformationen (Video-DAC). Für die Steuerung sind die 
zusätzlichen Chips "GALE" und "Budgie" verantwortlich. 


Der GALE-Chip ist ein programmierter Logik-Baustein der die 
Kommunikation zwischen CPU, ClAs und Erweiterungen steuert. Im 
Amiga 1200/4000 unterstützt er nur noch synchrone Prozessor- 
Operationen. 


Der BUDGIE-Chip enthält einige Logikfunktionen und steuert die 
Datenpufferung über den 32-Bit-Datenbus. 


Die Hardware-Register der drei Custom-Chips besitzen alle die gleiche 
Basisadresse, welche ab $OODFFOOO beginnt. Die Programmierung 
dieser Hardware-Register ist teilweise recht kompliziert. Doch kein 
Grund jetzt schon zu resignieren, denn schließlich besitzen Sie ja 
dieses Buch, mit Hilfe dessen ich versuchen werde, Ihnen die 
Programmierung besagter Hardware-Register so verständlich wie nur 
möglich zu vermitteln. 


Wie schon erwähnt können die Custom-Chips ausschließlich auf die 
ersten 512 KByte Speicher (Adresse: $000000 bis $O7ffff) zugreifen 
(OCS). Bei alten Amiga 1000 Modellen sogar nur auf die ersten 256 
KByte. Auf Grund dessen wird der Speicher auch CHIP-Speicher 
genannt. Versuche mit den Chips auf andere Speicher (FAST-Speicher) 
zugreifen zu wollen, endet meistens mit dem GURU... . Vielleicht sind 
Sie ja glücklicher Besitzer eines der neueren Amiga-Modelle, welche 
es ermöglichen mehr Chip-Speicher (siehe obige Tabelle) zu adres- 
sieren. 


Zum besseren Verständnis, folgen jetzt Abschnitte, in denen die 


Pinbelegung und Bedeutung der Signale der einzelnen Custom-Chips 
kurz beschrieben werden. 
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1.1.4.1 Der Agnus/Fat-Agnus-Chip 


Der Agnus-Baustein ist für die Steuerung des CHIP-RAMs zuständig, 
stellt die Video-Synchronsignale (HSY, CSY, VSY) zur Verfügung und 
enthält die Co-Prozessoren Blitter und Copper. Agnus enthält zu- 
sätzlich die komplette DMA-Logik für alle 6 möglichen Quellen (siehe 
Abschnitt 1.9). Für den zeitlichen Ablauf der einzelnen DMA-Zugriffe 
dient eine Bildschirmzeile als Zeitbezug. In jeder Zeile werden 225 
Speicherzu-griffe von Agnus auf die DMA-Kanäle und der CPU 
verteilt. Für das korekte Timing sind ein Zeilen- und ein Spaltenzähler 
verantwortlich (HSY, VSY). Über diese Signale kann das Timing auch 
extern gesteuert werden (Genlock). 


Der Blitter und der Copper werden in den entsprechenden Kapiteln 
abgehandelt. 


Tabelle der möglichen Agnus-Typen: 


ichnun ip-Size_ Ei im Ami Il 

8361 512 KB NTSC-Agnus für Ur-Amiga 1000, A2000 (A-Modell) 

8367 512 KB wie 8361, aber für PAL-Norm (Europa) 

8370 512 KB NTSC-FAT-Agnus für erste A500 und A2000 ab Rev. 
4. Zusätzlich 512 KB Slow-RAM möglich (ab Adresse 
$C00000). 

8371 512 KB PAL-Version des 8370 


8372-A 1024 KB Big-Agnus für ECS-Amigas (neuere A500, A2000 ab 
Rev. 6). Für beide Normen (PAL/NTSC, Umschaltbar) 

8372-B 2048 KB Super-Big-Agnus für Amiga 3000 (ECS). 

8375 2048 KB wie 8372-B, etwas Verbessert und andere Pinbele- 
gung. Für A500+ und A600. 
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Original-Pinbelegung von Agnus (48 Pins); 


Pın ___Name Funktion 

1-9  D8-DO Bits 8 bis O vom Datenbus (Verbunden mit den Registern) 

10  Vec Betriebsspannung (5 Volt) 

11 RES* Reset-Leitung 

2 INT Signal für Interrupt der Ebene 3 

13 DMAL DMA-Request-Line (DMA-Anforderung vom anderen CHIP) 

14 BLS* Blitter-Slow-Down (Blitter verlangsamen, weil CPU wartet) 

12 DBR* Data-Bus-Request (Datenbus-Anforderung) 

16 ARW* Agnus-RAM-Write (Agnus will auf Chip-Ram zugreifen) 

17-24 RGAB-RGA1 8-Bit-Register-Adress-Bus (Custom-Register anwählen) 

25 CcK Color-Clock (3,58 MHz Takt für Timing im Agnus) 

26 CCKQ Color-Clock-Delay (wie CCK, nur um 90 Grad Phasenverschoben) 
27 Ms Masse (0 Volt) 

28-36 DRAO-DRAB 9-Bit-DRAM-Adress-Bus (Ausgänge für DMA-Zugriff auf das CHIP- 


RAM). 
3 0 Light-Pen-Input (Eingang für Lichtgriffel) 
38  VSY* Vertical-Sync (vertikales Sync-Signal für Monitor) 
3 5° Composite-Sync (Summe von VSY und HSY) 
40° HSY* Horizontal-Sync (horizontales Sync-Signal für Monitor) 
4] Vss Masse (0 Volt) 


42-48 D15-D9 Bits 15 bis 9 vom Datenbus (Verbunden mit den Registern) 


* = low-aktives Signal 
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Pinbelegung vom Fat-Agnus (837Z-R3: 84 Pins); 


Funktion 


1-14 RD13-RDO Bits 13 bis O vom Register-Datenbus 


15 
16 
17 
18 
19 
20 
21 


34 
35 
36 
37 
38 
39 
40 
41 


42 
43-51 
52 
53 


Vec 
RST* 
INT3* 
DMAL 
BLS* 
DBR* 
RRW 
PRW 
RGEN* 
AS* 


Betriebsspannung (5 Volt) 
Reset-Leitung 
Signal für Interrupt der Ebene 3 


DMA-Request-Line (DMA-Anforderung vom anderen CHIP) 


Blitter-Slow-Down (Blitter verlangsamen, weil CPU wartet) 
Data-Bus-Request (Datenbus-Anforderung) 

DRAM Write/Read (Ausgang) 

Prozessor Write/Read (Eingang) 

Register Enable (CPU will auf Registerbereich zugreifen) 
Adress-Strobe (Eingang) 


RAMEN* RAM Enable (CPU will auf RAM-Bereich zugreifen) 
26-33 RGA8-RGA1 Acht-Bit breiter Register-Adress-Bus 


SCLK 
XCLK 
XCLKEN* 
CDAC* 
7MHZ 
CCKQ 
CCK 

Test 
NTSCUPAL 
GND 
MAO-MAB 
LDS* 
UDS* 
CASL* 
CASU* 
RASI1* 
RASO* 
GND 
A19-A1 
LP» 

VSY" 
EST” 
HSY* 
GND 


28 MHz-Master-Takt für das gesammte Amiga-Timing 
alternativer Master-Takt-Eingang 

alternativen Master-Takt aktivieren 

phasenverschobener u. invertierter 7 MHZ-Taktausgang 

7 MHZ-Taktausgang (SCLK/4) 

Color-Clock-Delay (verzögerter Takt-Ausgang) 

Color-Clock (Takt-Ausgang: 3,58 MHz) 

Test-Zugriff auf Register (OCS-Amiga) 

Video-Norm einstellen (ECS-Amiga) 

Masse-Leitung 

Acht-Bit Ausgabe-Bus 

Lower-Data-Strobe (Eingang für LDS-Signal von der 68000-CPU) 
Upper-Data-Strobe (Eingang für UDS-Signal von der 68000-CPU) 
Column-Adress-Strobe-Lower (ChIP-RAM-Bereich Ansteuerung) 
Column-Adress-Strobe-Upper (CHIP-RAM-Bereich-Ansteuerung) 
Row-Adress-Strobe-1 (Chip-RAM-Bereich-Ansteuerung) 
Row-Adress-Strobe-O (CHIP-RAM-Bereich-Ansteuerung) 
Masse-Leitung 

19-Bit Adress-Bus (59 = A19, 60-77 = A1-A18) 
Light-Pen-Input (Eingang für Lichtgriffel) 

Vertical-Sync (vertikales Sync-Signal für Monitor) 
Composite-Sync (Summe von VSY und HSY) 

Horizontal-Sync (horizontales Sync-Signal für Monitor) 
Masse-Leitung 


83-84 RD15-RD14 Bits 14 und 15 vom Register-Datenbus 


* = low-aktives Signal 
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1.1.4.2 Der Denise-Chip 


Denise übernimmt die meisten Aufgaben für die Bildschirmdarstell- 
ung. Dafür werden die Register von Denise mit den aktuellen Grafik- 
daten durch Agnus "gefüttert". Über einen Bitebenen-Sequenzer 
werden die parallelen Daten (16 Bit) in serielle umgewandelt. Danach 
werden die Daten entsprechend der eingestellten Prioritäten der 
Sprites/Bitplanes bearbeitet. Für jeden Pixel wird nun über eine 
Farbkodierung das entsprechende Farbregister ausgewählt. An- 
schließend wird der darin enthaltende Wert als digitales RGB-Signal 
ausgegeben. 


Zusätzlich gelangen die Daten zu einer Kollisionskontrolllogik, die die 
Daten auf Kollisionen untersucht und das Ergebins in das Kollisions- 
register einträgt. 


Denise enthält auch die aktuellen Werte der beiden Mausports. Wie 
diese abgefragt werden, wird im Abschnitt 17.2 und 14 beschrieben. 


Mit dem Amiga 3000 wurde auch eine neue Hires-Denise eingeführt. 
Sie ist fast 100% Pinkompatibel und kann im Prinzip in jedem Amiga 
eingesetzt werden. Allerdings kommen die neuen Features nur im 
Zusammenspiel mit einem Big-Agnus (2 MByte Chip-RAM) zur Aus- 
wirkung. Dadurch wird die Verdoppelung der Zeilenfrequenz 
ermöglicht und die Darstellung des Productivity-Modus (640x480, 4 
Farben, 60 Hz) und des Super-Hires-Modus (1280x256). Zur 
Realisierung benötigt man einen speziellen Monitor (Multisync). Die 
Bildformate und die Polarität der Synchronisationssignale können jetzt 
auch frei programmiert werden (siehe Abschnitt 10). 
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Denise 8362: OCS-Amigas (Amiga 1000/500/2000) 
Denise 8373: ECS-Amigas (Amiga 500/500plus/2000/3000) 


Pinbelegung von Denise (6362/8373: 48 Pins); 


Pin Funkti 

1-7  D6-DO Bits 6 bis O vom 16-Bit-Datenbus (verbunden mit Chipdatenbus) 
8-9 MHI1-MHO Mausport1/O horizontal (siehe Schnittstellen: Gameports) 

10-17 RGAB-RGA1 Acht-Bit-Register-Adress-Bus 

18 Burst*  Color-Burst-Signal für Videoanschluß (Abhängig von CCK) 

19 Vcc Betriebsspannung (5 Volt) 

20-23 RO-R3 Rotanteil des digitalen RGB-Signals (vier Bits) 

24-27 BO-B3 Blauanteil des digitalen RGB-Signals (vier Bits) 

28-31 GO-G3 Grünanteil des digitalen RGB-Signals (vier Bits) 


32 NC Not connected (keine Funktion bei OCS-Amigas, Denise 8362) 
CSYNC* Composite Sync-Signal (nur bei ECS-Amigas, Denise 8373) 

33 ZD* Background Indicator (Hintergrund-Farberkennung für Farbreg. 0) 

34 NC Not connected (keine Funktion bei OCS-Amigas, Denise 8362) 
CDAC _CDACK-Clock-Eingang (nur ECS-Amigas, Denise 8373) 

35 7M 7 MHz-Eingang für das Timing der Bildausgabe 


36 CCK Color-Clock (Takteingang: 3,58 MHz für Denise-Timing) 

37 GND Masse-Leitung 

38-39 MOV-M1V MausportO/1 vertikal (siehe Schnittstellen: Gameports) 

40-48 D15-D7 Bits 15 bis 7 vom 16-Bit-Datenbus (verbunden mit Chipdatenbus) 


* = low-aktives Signal 
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1.1.4.3 Der Paula-Chip 


Paula ist der einzige Chip, der seit dem Ur-Amiga keinen Veränder- 
ungen unterlag. Das ist auch die Ursache, warum der Amiga keine 
HD-Laufwerke unterstützt, Musik "nur" in 8-Bit abspielen kann und 
die serielle Datenübertragung nicht auf den maximalen Wert von 
115.000 cps einstellbar ist. 


Paulas Aufgabenbereich umfaßt die Ein- Ausgabesteuerung für 
Diskettenlaufwerke, Tonausgabe, Abfrage der Analogeingänge (über 
Gameports) und die serielle Datenübertragung (UART-Baustein). Alles 
läuft über eigene DMA-Kanäle, die über das DMAL-Signal an 
Agnus/Alice angemeldet werden. 


In dem Prozessorabschnitt haben wir schon erfahren, daß der Amiga 
eine Vielzahl von Interrupts erlaubt. Alle Interrupts, die durch die 
Custom-Chips erzeugt werden können, werden hier im Chip 
verarbeitet und entsprechend für die CPU aufbereitet. Paula kann 
Interrupts der Ebene 1 bis 6 erzeugen, doch dazu mehr im Abschnitt 
1.8. 


Pinbelegung von Paula (8364: 48 Pins): 


Pin ___Name Funktion 

1-7 D8-D2 Bits 8 bis 2 vom 16-Bit-Datenbus (verbunden mit Chipdatenbus) 

8 Gnd Masse-Leitung 

9-10 DI-DO Bits 1 bis O vom 16-Bit-Datenbus (verbunden mit Chipdatenbus) 

11 RES” Reset-Leitung 

12 DMAL DMA-Request-Line (DMA-Anforderung an Agnus/Alice) 

13-15 IPLO-IPL2* Interrupt-Pending-Level (mit CPU verbunden; erzeugt dadurch die 
entsprechende Ebene) 

16-18 INT2/3/6* Interrupt-Level 2/3/6. (signalisieren Paula, daß ein Interrupt der 
Ebene 2/3/6 aufgetreten ist) 

19-26 RGAB-RGAI Acht-Bit-Register-Adress-Bus 

27 Vcc Betriebsspannung (5 Volt) 

28 CCK Color-Clock (3,58 MHz-Taktausgang) 
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29 CCKQO Color-Clock-Delay (siehe Agnus/Denise) 

30-31 AUDB/A rechter/linker Audiokanal-Ausgang 

32-33 POTOX/Y verbunden mit Gameporteingängen zum Anschluß von Paddles/ 
Analog-Joysticks. Können auch als Ausgang geschaltet werden. 

34 GNDANA Masse-Leitung für analoge Eingänge 

35-36 POTIX/Y wie POTOX/Y, aber für Gameport 1 

37 DKRD* Disk-Read-Data (Daten von Diskette einlesen) 

38 DKWD*  Disk-Write-Data (Daten auf Diskette schreiben) 

39 DKWE Disk-Write-Enable (Umschaltung für Disk-Daten Schreiben/Lesen) 

40 TXD Serial-Transmit-Data (Sendedaten für seriellen Port) 

41 RXD Serial-Receive-Data (Empfangsdaten vom seriellen Port) 

42-48 D15-D9 Bits 15 bis 9 vom 16-Bit-Datenbus (mit Chipdatenbus verbunden) 


* = low-aktives Signal 
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1.1.4.4 Der Alice-Chip 


Auf die Funktion vom Alice-Chip sind wir ja schon kurz eingegangen. 
Er ist die Weiterentwicklung des Big-Agnus. Alice wurde komplett neu 
gestyt und speziell auf die neueren CPUs (ab MC68020) 
zugeschnitten. Weil bei diesen Prozessoren der Bus 32-Bit breit ist, 
konnten einige Signale zusammengefaßt bzw. entfernt werden. 


As" => N (not connected - nicht mehr vorhanden) 
ALCKACKEN => 14 MHz und Nc 

LDS"/UDS* => Vcc und Nc 

(CASWCAS => jelzt eine (AS-Leitung 

RASWURAS] => eine RAS-Leitung und zusätzlich DRAI 


Die anderen Signale entsprechen im Prinzip den alten, bei gleicher 
Pinbelegung. Durch die internen Veränderungen tragen diese Signale 
jetzt andere Bezeichnungen. 


Der Alice-Chip kann leider nicht in alte Amigas eingebaut werden. Er 
ist nur für die Amigas mit AA-Chip-Set entwickelt worden (A1200/ 
4000). 


Pinbelegung von Alice (8374: 84 Pins); 


Pin ___Name Funktion 

1-14 DRD13-DRDO Bits 13 bis O vom 16-Bit-DRAM-Datenbus 

15. ke Betriebsspannung (5 Volt) 

16 RST* Reset-Leitung 

17 INT3* Signal für Interrupt der Ebene 3 

18 DMAL DMA-Request-Line (DMA-Anforderung vom anderen CHIP) 


19  BLS* Blitter-Slow-Down (Blitter verlangsamen, weil CPU wartet) 
20  DBR* Data-Bus-Request (Datenbus-Anforderung) 

21  \WE* Write-Enable für DRAM 

22  _PRW Prozessor Read/Write (Eingang) 

23 RGEN* Register Enable (CPU will auf Registerbereich zugreifen) 

24 NC2 not connected (keine Verbindung- bei Agnus hier AS-Signal) 


25 RAMEN* RAM Enable (CPU will auf RAM-Bereich zugreifen) 
26-33 RGAB-RGA] Acht-Bit breiter Register-Adress-Bus 
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34 SCLK 28 MHz-Master-Takt für das gesammte Amiga-Timing (Eingang) 
35 A20 Bit 20 vom 20-Bit Adress-Bus 

36 14MHz 14 MHz-Ausgang 

37 _CDAC* phasenverschobener u. invertierter 7 MHZ-Taktausgang 
38 7MHZ 7 MHZ-Taktausgang (SCLK/4) 

39 CCKQ Color-Clock-Delay (verzögerter Takt-Ausgang) 

40° CCK Color-Clock (Takt-Ausgang: 3,58 MHz) 

41. NTSCUPAL Video-Norm einstellen 

42  GND2 Masse-Leitung 

43-51 DRAO-DRAAB Bits O bis 8 vom 10-Bit-DRAM-Adress-Bus 

52  Vec2 Betriebsspannung (5 Volt) 

53 Na not connected (nicht belegt) 

54 CAS" Column-Adress-Strobe (ChIP-RAM-Bereich Ansteuerung) 
55  VBB 

56 DRA9 Bit 9 vom 10-Bit-DRAM-Adress-Bus (1024 KByte) 

57 _RAS* Row-Adress-Strobe (CHIP-RAM-Bereich-Ansteuerung) 

58 GND3 Masse-Leitung 

59-77 AlY-A1 19-Bits vom 20-Bit-Adress-Bus (59 = A19, 60-77 = A1-A18) 
78 _LPEN* Light-Pen-Input (Eingang für Lichtgriffel) 

79 _VSYNC*  Vertical-Sync (vertikales Sync-Signal für Monitor) 

80 CSYNC* _ Composite-Sync (Summe von VSY und HSY) 

81 HSYNC*  Horizontal-Sync (horizontales Sync-Signal für Monitor) 
82 GNDI Masse-Leitung 

83-84 DRD15-DRD14 Bits 14 und 15 vom 16-Bit-DRAM-Datenbus 


* = low-aktives Signal 
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1.1.4.5 Der Lisa-Chip 


Der alte Denise-Baustein wurde für die Modelle A1200/4000 
komplett neu entwickelt. Durch den 32-Bit-Datenbus und die jeweils 
8-Bit breiten Farbanteile (RGB) verfügt Lisa über ein 84-Pin-Gehäuse. 
Die Funktion ist prinzipiell die Gleiche wie die von Denise. 


Für die Videoausgabe ist zusätzlich noch ein Video-D/A-Wandler 
(Video-DAC) hinzugekommen. Dieser wandelt den digitalen 24-Bit- 
RGB-Wert von Lisa in ein analoges RGB-Signal für den 23-poligen 
Video-Port. 


Auch Lisa ist nicht einbaufähig in alte Amiga-Modelle. 


Pinbelegung von Lisa (4203: 84 Pins); 


Pın___Name Funktion 

1 GNDI Masse-Leitung 

2-8  D6-DO Bits 6 bis O vom 32-Bit-CPU-Datenbus 

9 CAS* Column-Adress-Strobe für DRAM 

10 CCK Color-Clock (3,58 MHz-Eingangstakt) 

N WIDE Signal für AA-Gale 

12-19 RGAB-RGA1 Acht-Bit-Register-Adress-Bus 2 

20 MDAT Eingang für MxH- u. MxV-Signale. Über eine spezielle Schaltung 
werden die Mx-Signale generiert 

21 MLD* wie MDAT, aber als Ausgang 

22 SCLK 28 MHz-Ausgangstakt 

23 C140 14 MHz-Ausgangstakt 

24 RST* Reset-Leitung 

25 C28M 28 MHz-Master-Eingangstakt 

26 SOG für Video-DAC 

27 Blank für Video-DAC 

28 ZD Background-Indicator (siehe Denise) 

29 BO geht direkt zum Video-DAC (Blauanteil, Bit O) 

30 Vcc1 Betriebsspannung (5 Volt) 

31-32 B1-B2 geht direkt zum Video-DAC (Blauanteil, Bits 1 bis 2) 

33 GND2  Masse-Leitung 

34-38 B3-B7 geht direkt zum Video-DAC (Blauanteil, Bits 3 bis 7) 
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39-42 GO-G3 
43 C280 
44-47 G4-G7 
48-52 RO-R4 
53 GND3 
54-55 R5-R6 
56 Vcc2 
57 R7 
58 BRST* 
59-82 D31-D8 
83 Vcc3 
84 D7 


geht direkt zum Video-DAC (Grünanteil, Bits O bis 3) 
28 MHz-Ausgang 

geht direkt zum Video-DAC (Grünanteil, Bits 4 bis 7) 
geht direkt zum Video-DAC (Rotanteil, Bits O bis 4) 
Masse-Leitung 

geht direkt zum Video-DAC (Rotanteil, Bits 5 bis 6) 
Betriebsspannung (5 Volt) 

geht direkt zumVideo-DAC (Rotanteil, Bit 7) 
Burst-Signal 

Bits 31 bis 8 vom 32-Bit-CPU-Daten-Bus 
Betriebsspannung (5 Volt) 

Bit 7 vom 32-Bit-CPU-Daten-Bus 


* = low-aktives Signal 
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1.1.4.6 Der AA-Gale-Chip 


"Gale" und "Budgie" sind für die Steuerung des Amiga-Systems 
zuständig. Sie enthalten alle notwendigen Signale für den reibungs- 
losen Ablauf aller Bausteine untereinander. So steuert der Gale-Chip 
z.B. die ClAs (Signale: ODD_CIA, EVEN _CIA). Er enthält ebenfalls alle 
nötigen Signale, einschließlich der integrierten Signale für den 
internen IDE-Kontroller, um mit dem Prozessor kommunizieren zu 
können (nur noch synchron). 


Die Logik-Funktionen vom Gale, sind auch wie bei Lisa und Alice in 
einem 84-Pin-Gehäuse untergebracht. 
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1.2 Amiga-Schnittstellen 


Der Amiga verfügt über alle möglichen Schnittstellen, die zum Be- 
trieb von externer bzw. interner Periepherie notwendig sind. Jedoch 
besitzen nicht alle Amiga-Modelle die gleichen Schnittstellen. Das 
wäre aufgrund der Bauweise auch nicht möglich. 


Die Modelle A500/600/1200 bieten die kleinste Zahl an Erweiter- 
ungsmöglichkeiten, bedingt durch die flache Bauweise. 


Welche Möglichkeiten die einzelnen Modelle aufweisen, und wie die 
jeweilige Schnittstelle aufgebaut ist, wird in den folgenden Ab- 
schnitten beschrieben. 


1.2.1 Die Audio-/Video-Schnittstelle 


Für die Audioverbindung besitzen alle Modelle zwei Cinchbuchsen. 
Eine rote (rechter Kanal) und eine weiße (linker Kanal) Buchse. Der 
Amiga besitzt vier Soundkanäle. Jeweils zwei werden zusammengefaßt 
und auf eine Audiobuchse ausgegeben. An diesen Buchsen können 
Stereoanlagen, Monitore mit Audioeingang und Verstärker ange- 
schlossen werden. 


Für die Videoausgabe besitzt der Amiga 1000 eine runde 8polige 
Buchse mit folgender Belegung: 


Funkti 
NC not connected (nicht belegt) 
GND Masse-Leitung 

Audioleft linker Audiokanal 
CompVideo Composite-Video-Ausgang 
GND Masse-Leitung 

NC not connected (nicht belegt) 
+12V 12 Volt-Spannung 
AudioRight rechter Audiokanal 


osnouswnolß 
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Einige Modelle verfügen zudem über eine gelbe Cinchbuchse, an der 
ein Composite-Video-Signal anliegt (FBAS=Farb-Bild-Abtast-Synchron- 
Signal). Dieses Signal liefert bei einigen Modellen aber nur ein S/W- 
Bild (BAS) und evtl. ein NTSC-Signal. 


In den Modellen A600/1200 integrierte man noch eine TV-Modula- 
tor-Schaltung, welche ein Antennensignal liefert. Hier kann über ein 
handelsübliches Antennenkabel ein Fernseher angeschlossen werden 
(Kanal 36). Die Bildqualität läßt jedoch zu wünschen übrig. Für den 
A500 werden externe TV-Modulatoren angeboten, die man an den 
RGB-Port anschließt. 


Der Amiga 3000 besitzt noch einen 15poligen Videoausgang für 
VGA-Monitore. 


31 KHz-Video-Port (A3000) 
(SUB-D 15-Pin/weiblich) 


Pin Name Funktion 

1 RED-Video Rotanteil vom Video 
2 GREEN-Video Grünanteil vom Video 
3 BLUE-Video Blauanteil vom Video 
4 Monitor-ID-Bit2 nicht belegt 

5 GND Masse-Leitung 

6 RED-Return Masse für Rotanteil 

7 GREEN-Return Masse für Grünanteil 
8 BLUE-Return Masse für Blauanteil 
9 Key nicht belegt 

10 Sync-Return Masse 


11 Monitor-ID-BitO nicht belegt 
12 Monitor-ID-Bit] nicht belegt 


13 HSync horizontales Sync.-Signal 
14 VSync vertikales Sync-Signal 
15 NC nicht belegt 


Zusätzlich bieten die Modelle A2000/3000/4000 noch einige Video- 
Slots. Hier könnten Grafikkarten, Antiflickerkarten usw. eingebunden 
werden. 
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A = Standard-Video-Slot (A2000/3000) 
B = Extended-Video-Slot (A2000BC/3000) 
C = Video-Slot (A4000) 
Video-Slot-Steckerleiste (36-Pin): 

Pin _ A-Funktion B-Funktion C-Funktion 

1 reserviert Masse RO 

2 reserviert RO RI 

3 Audio-links-gefiltert R1 Audio-links-gefiltert 

4 Audio-rechts-gefilt. R2 Audio-rechts-gefiltert 

5 reserviert Masse C280 (28 MHz-Ausgang) 

6 +5VDC GO +5VDC 

7 analog Rot Gl analog Rot 

8 +5VDC G2 +5VDC 

9 Video-Masse Masse Video-Masse 

10 +12VDC Bl + 12VDC 

11 analog Grün B2 analog Grün 

12 Video-Masse Masse Video-Masse 

13 Video-Masse Composite-Video Video-Masse 

14 CSync* TBASE CSync* 

15 analog Blau CDACK-Clock analog Blau 

16 XCLKEN* POUT XCLKEN* 

17 Video-Masse C3-Clock* Video-Masse 

18 Burst Busy Burst 

19 C4-Clock* LPEN* C4-Clock* 

20 Video-Masse Acknowledge* Video-Masse 

21 Video-Masse SEL Video-Masse 

22 HSync* (47 Ohm) Masse HSync* (47 Ohm) 

23 BO=DI (47 Ohm) PDO B4=DI (47 Ohm) 

24 Video-Masse PDI Video-Masse 

25 B3=DB (47 Ohm) PD2 B7=DB (47 Ohm) 

26 VSync* (47 Ohm) PD3 VSync* (47 Ohm) 

27 G3=D6 (47 Ohm) PD4 G7=D6 (47 Ohm) 

28 analoges CSync PD5 Blank 

29 R3=DR (47 Ohm) PD6 R7=DR (47 Ohm) 

30 PIXELSW* (47 0.) PD7 PIXELSW* (47 Ohm) 

31 -5VDC LED* -5VDC 

32 Video-Masse Masse Video-Masse 

33 XCLK Raw-Audio-Left XCLK 

34 C1-Clock* Audio-Masse C1-Clock* 

35 reserviert Raw-Audio-Right +5VDC 

36 PSTROBE (nicht Audio-Masse PSTROBE 

bei Ur-A2000) 
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Der Extended-Video-Slot für den Amiga 4000 hat eine 54-Pin 
Steckerleiste mit folgender Belegung: 


Video-Slot-Steckerleiste für A4000 (54-Pin): 


Pin_Funktion 
Masse 
R4 

R5 

R6 
Masse 
G4 

G5 

G6 
Masse 
B5 

B6 
Masse 
SOG 
TBASE 


— u u u u 
BOn.S2sSsyvnnsouswun. 


Pin Funktion Pin_ Funktion Pin_ Funktion 
15 CDACK-Clock 29 PD6 43 Masse 
16 POUT 30 PD? 44 Masse 
17 ©3-Clock* 31 LED* 45 R2 
18 BUSY 32 Masse 46 R3 
19 LPEN* 33 RawAudioleft 47 GI 
20 Acknowldge* 34 Audio-Mase 48 G2 
21 SEL 35 RawAudioRight 49 G3 
22 Masse 36 Audio-Mase 50 G4 
23 PDO 37 reserviert 51 BO 

24 PDI 38 reserviert 52 B 
253 PD 39 Masse > BZ 
26 PD3 40 Masse 54 B3 
27 PD4 41 reserviert 

28 PDS 42 reserviert 


1.2.2 Der RGB-Port 


Die RGB-Buchse ist bei allen Modellen identisch belegt. Hierüber 
können analoge und digitale Monitore angeschlossen werden. Die 
Bildqualität ist über diesen Port am besten, da die Rot-, Grün- und 
Blauanteile direkt am Ausgang anliegen. 


Pin Name 
XCLK* 


_— 


XCLKEN* 
RED 
Green 
Blue 

DI 


ONın 2 WN 


RGB-Port (alle Modelle) 
(SUB-D 23-Pin/männlich) 


Funktion 

Externer Takt für Amiga-Timing (Ersetzt den 28MHz-Master- 
Takt für alle Custom-Chips) 

Externen Takt zulassen (O=Taktfreigabe) 

analoges Rot-Signal 

analoges Grün-Signal 

analoges Blau-Signal 

Intensität des digitalen Signal 
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i DB digitales Blau-Signal 

8 DG digitales Grün-Signal 

9 DR digitales Rot-Signal 

10 CSync* Composite-Synchronisationssignal 

11 HSync* horizontales Sync-Signal (Aus- und Eingang) 
12 VSync* vertikales Sync-Signal (Aus- und Eingang) 
13 GNDRTN Masse für XCLKEN* 

14 ZD* Zero Detect (Background-Indikator) => siehe Custom-Chips 
15 Cr Ausgangstakt von 3,55 MHz 

16-20 GND Masse 

21 -5 Volt -5V/50mA oder -12V/175mA (nur A500) 
22 +12 Volt + 12V/175mA 

23 +5 Volt +5V/300mA 


1.2.3 Die Centronics-Schnittstelle 


Die parallele Schnittstelle, auch Centronics-Schnittstelle genannt, 
entspricht genau dem PC-Standard. Lediglich der A1000 hat eine 
andere Pinbelegung. Hier muß ein spezielles Kabel verwendet 
werden, andernfalls könnte das Ihren A1000 evtl. zerstören. Bei allen 
anderen Modellen sind alle gängigen Drucker anschließbar. 
Entsprechende Druckertreiber befinden sich auf der Workbench- 
Diskette oder sind kommerziell zu erwerben. 


A = Parallel-Port für alle Modelle außer A1000 (SUB-D 25-Pin / weiblich) 
B = Parallel-Port für A1000 (SUB-D 25-Pin / männlich) 
Pin-A_Pin-B__Name Funktion 
1 1 STROBE* Strobe-Signal. Hiermit signalisiert die CPU, daß gülitge Daten 


anliegen. 

2-9 2-9  DO-D7  8-Bit-Datenbus bidirektional 

10 10  ACK* Acknowledge. Hiermit signalisiert der Drucker, daß diie Daten 
übernommen wurden. 

11 11 BUSY Drucker arbeitet und kann momentan keine Daten über- 
nehmen (BUSY=0) 
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12 12  POUT 
13 13 -SEL 
14 23 +5V 
15 24  NC 
16 25  Reset* 
17-22 17-22 GND 
23 14 GND 
24 15 _GND 
25 16 GND 
Alle oben 
verbunden. 
Abschnitt 1. 


Paper-Out. Kein Papier im Drucker. 

Drucker selektiert (1 =Online) 

5V/100mA (47 Ohm-Pullup-Widerstand) 

not connected (nicht belegt) 

Reset-Leitung 

Masse-Leitung 

Masse-Leitung 

Masse-Leitung 

Masse-Leitung * 


aufgeführten Signale sind mit den CIA-Bausteinen 
Die Verbindungen der einzelnen Signale werden im 
1.3 behandelt. 


1.2.4 Die serielle Schnittstelle (RS232) 


Die serielle Schnittstelle enthält alle notwendigen Signale, die zur 
Kommunikation mit einem Modem erforderlich sind. Die ersten 8- 
Pins und Pin 20 entsprechen genau dem RS232-Standard und sind 
bei allen Amiga-Modellen gleich belegt. Die restliche Pinbelegung 
unterscheidet sich von der des A1000. Alle Leitungen werden über 
Treiber geführt, die die notwendigen Signale liefern. 


vzun-ilß 


Dos 


13 


Name 
Shield* 
TXD 
RXD 
RTS 
CTS 


DSR 
GND 
CD 
NC 


Serieller-Port (A1000) 
(SUB-D 25-Pin/weiblich) 


Funktion 

Abschirmung (nicht mit normaler Masse verbinden) 

Transmit Data (serieller Ausgang der Daten) 

Receive Data (serieller Eingang für Daten) 

Request to Send (Amiga ist bereit, serielle Daten zu übertrag.) 
Clear to Send (Periepherie meldet über diese Leitung, daß es 
empfangsbereit ist) 

Data Set Ready (Periepherie meldet Betriebsbereitschaft) 
Masse-Leitung 

Carrier Detect (Modem meldet, Trägerfrequenz empfangen) 
not connected (nicht belegt) 
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14 -5 Volt 
15 AUDO 
16 AUDI 
17 EB 

18 INT2* 
19 NC 

20 DTR 

21 +5 Volt 
22 NC 

23 +12 Volt 
24 2» 

25 RESB* 


-5V/50mA 

Audioausgang für linke Kanäle O und 3 

Audioeingang für rechte Kanäle 1 und 2 (wird mit Kanal 1 u. 
2 gemischt) 

gepufferter Porttakt von 716 KHz 

Interrupt der Ebene 2 aktivieren, wenn Maske diesen erlaubt 
not connected (nicht belegt) 

Data Terminal Ready (Meldung an Periepherie, daß serielle 
Schnittstelle jetzt in Betrieb ist) 

+5V/100mA 

not connected (nicht belegt) 

+ 12V/50mA 

3,55 Mhz Taktausgang 

Reset-Leitung 


Serieller-Port (alle Modelle, außer A1000) 


Pin 

9 +12 Volt 
10 -12 Volt 
11 AUDO 
12-17 NC 

18 AUDI 
19 NC 

20 DTR 

21 NC 

22 RI 
23-25 NC 


(SUB-D 25-Pin/männlich) 


F 


1-8 siehe Beschreibung von A1000 


+12 Volt-Ausgangsspannung 

-12 Volt Ausgangsspannung 

Audioausgang für linke Kanäle O und 3 

not connected (nicht belegt) 

Audioeingang für rechte Kanäle 1 und 2 

not connected (nicht belegt) 

Data Terminal Ready (siehe A1000-Beschreibung) 
not connected (nicht belegt) 

Ring-Indikator (ankommender Ruf) 

not connected (nicht belegt) 


Seite 87 


Hardwaregrundlagen Kapitel 1 


1.2.5 Die Gameports 


Die Gameports sind wohl mit die wichtigsten Anschlüsse für den 
Amiga-User. Hier können Eingabegeräte wie Maus (max. 3 Knöpfe), 
digitale Joysticks (max. 2 Knöpfe), analoge Joysticks und Lightpens 
angeschlossen werden. 


Die Eingabetasten (Knöpfe) sind mit der CIA-A und die verbleibenden 
mit den Bausteinen Denise/Lisa bzw. Agnus/Alice verbunden. 
Teilweise sind noch irgendwelche Logik-Schaltungen dazwischen. 


Durch die vier möglichen Eingabearten ergibt sich jedesmal eine 


andere Signalfunktion bzw. -belegung. 


Gameports (alle Modelle) 
(Sub-D 9-Pin / männlich) 


Pin_ Maus digitaler Joy. ana Ligh 

1 V-Impulse Oben extra Knopf unbenutzt 

2 H-Impulse Unten unbenutzt unbenutzt 

3 VQ-Impulse Links linker Knopf unbenutzt 

4 HQ-Impulse Rechts rechter Knopf unbenutzt 

5 mittlerer Knopf unbenutzt rechtes Poti Lightpenknopf 
6 linker Knopf Feuerknopf unbenutzt Lightpen-Signal 
7 +5 Volt +5 Volt +5 Volt +5 Volt 

8 Masse Masse Masse Masse 

9 rechter Knopf unbenutzt linkes Poti unbenutzt 


Wie die einzelnen Geräte abgefragt werden, wird in den entsprechen- 
den Kapiteln beschrieben. Zu den analogen Joysticks sei noch gesagt, 
daß die Anschlüsse 5/9 mit einem Widerstandswert von 47 kiloohm 
+/- 10% betrieben werden können. Dieser veränderbarer Widerstand 
wird zwischen Pin 5/9 und 7 (+5 Volt) geschaltet. Die PotxDat- 
Register ($DFFO12/16) enthalten dann den jeweils dazugehörigen 
Wert. 
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1.2.6 Die Diskettenlaufwerke 


Am Amiga können bis zu vier Diskettenlaufwerke angeschlossen 
werden. Jeder Amiga hat von Haus aus schon ein Laufwerk intern 
eingebaut. Dieses ist an eine seperate Steckerleiste angeschlossen, die 
eine etwas andere Pinbelegung aufweist. Alle anderen Laufwerke 
werden mit einer 23poligen SUB-D-Buchse verbunden. Da nur eine 
Buchse existiert, muß jedes Laufwerk einen durchgeführten Port 
besitzen, was heutzutage zweifellos der Fall ist. 


Bei den Laufwerken handelt es sich in der Regel um 3,5 Zoll- 
Laufwerke mit einer Kapazität von 880 KByte. Ebenfalls anschließbar 
sind 5,25 Zoll-Laufwerke. Im aktuellen Betriebssystem wird das 720 
KByte-PC-Format unterstützt. Wenn man Laufwerke mit anderer 
Kapazität anschließen möchte (HD), ist ein spezieller Treiber 
notwendig. 


Externe Diskettenschnittstelle (alle Modelle) 


(SUB-D 23-Pin/weiblich) 


Pin Funkti 

1 RDY* wenn MTR-Leitung=0, dann signalisiert RDY, daß das Lauf- 
werk betriebsbereit ist. 
wenn MTR-Leitung= 1, dann ist der Identifikatiosmodus aktiv. 

2 DKRD* über diese Leitung werden die Daten serielle eingelesen 

3-7 GND Masse-Leitungen 

8 MTRXD* Motor einschalten von Laufwerk X, daß über SEL X angewählt 
wurde (über FlipFlop-Schaltung) 

9 SEL2B* Laufwerk 2 selektieren. Alle Signale haben erst jetzt eine Aus- 
wirkung (außer MTRXD* und DRESB*) 

10 DRESB* Laufwerke reseten (FlipFlops zurücksetzen: Motor ausschalten) 

1 CHNG* Diskettenwechselsignal (O=keine Disk, 1=Disk im Laufwerk 
=> wird erst nach einem STEP-Impuls aktualisiert) 

12 +5 Volt 5V/270mA max., wenn Pegel unter 3,75 Volt, dann Reset 

13 SIDEB* Diskettenseite wählen (0 = Seite 1, 1 = Seite 0) 

14 WPRO* Schreibschutzsignal wenn Diskette im Laufwerk (0 = geschützt) 

15 TKO* immer Null, wenn Schreib/Lesekopf über Track Null 

16 DKWEB* Disk-Write-Enable (Schreib-/Leseumschaltung => 0 = Daten 
auf Diskette schreiben, 1 = Daten von Diskette lesen) 

17 DKWDB* Disk-Write-Data (von hier gelangen die Daten auf Diskette) 
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18 STEPB* Schreib-/Lesekopf bewegen (positive Flanke = Kopf bewegen 
=> DIRB gibt die Richtung an) 

19 DIRB Richtung der Schreib-/Lesekopfbewegung (1 = nach Außen, 
Track Null) 

20 SEL3B* wie SEL2B*, nur für Laufwerk 2. 

21 SELIB* wie SEL2B*, nur für Laufwerk 1. 

22 INDEX* Index-Signal vom Laufwerk. Einmal pro Umdrehung zwischen 


Ende und Anfang einer Spur. Es kann ein Interrupt der Ebene 
6 erzeugt werden. 
23 +12 Volt 12V/160 mA max. 


Das interne Laufwerk ist über eine 34-Pin-Steckerleiste angeschlossen. 
Die Signale sind vergleichbar mit denen der externen Buchse. 
Natürlich ist die Anzahl geringer, da hierüber nur ein Laufwerk 
angeschlossen wird (ist). Ein Signal ist neu. Es trägt die Bezeichnung 
"INUSE" und ist mit der FLOPPY-LED verbunden. 


interne Diskettenschnittstelle (alle Modelle) 
(34-Pin-Steckerleiste) 


Pin _Funkti Pin_Funktion Pin_ Funktion Pin_ Funktion 
2 CHNG* 10 SELO 20 STEPB* 28 \WPRO* 
4 INUSE*(MTROD*) 12/14 unbelegt 22 DKWDB* 30 DKRD* 
6 unbelegt 16 MTROD* 24 DKWEB* 32 SIDEB* 
8 INDEX* 18 DIRB 26 TKO* 34 RDY* 


alle ungeraden Pins liegen auf Masse (* = lowaktiv) 


Wie die einzelnen Signale abgefragt bzw. gesetzt werden, wird 
ausführlich im Kapitel 2 bis 5 erläutert. Dort ist die vollständige 
Diskettenprogrammierung beschrieben. 


Die interne Floppy erhält ihre Spannungsversorgung über einen 
4poligen Stecker. 


interne_Diskettenspannungsversorgung (alle Modelle) 
(4poliger Stecker) 


Pin Funktion Pin Funktion 
1 +12 Volt 3 Masse 
2 Masse 4 +5 Volt 
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1.2.7 Der Expansions-/Prozessorport 


Am Expansionsport liegen alle wichtigen Leitungen des Amiga- 
systems. Hier können alle erdenklichen Erweiterungen angeschlossen 
werden (RAM-, Turbo-, PC-Karten usw.). 


Der Expansionsport befindet sich beim Amiga 500/2000 auf der 
linken Seite und beim A1000 auf der Rückseite. Dieser Port ist 86-Pin 
breit und hat die gleiche Belegung wie der Zorroll-Steckplatz vom 
A2000 (siehe nächsten Abschnitt). 


Der Amiga 1200 kann über einen internen Schacht auf der Unterseite 
erweitert werden. 


E iO rt (A500/1 2 
(86 poliger Platinenstecker) 


Pin _Funkti Pin_Funkti Pin_Funkti 

1-4 Masse 31 FCO 53 RSI” 

5-6 +5VDC 32 AI9 54 AI19 

7 unbelegt 33 FC ss HL 

8 -5VDC 34 AIO 56-59 A2O bis A23 

9 A500/1000: frei 3 MR 60 A500/1000/2000: BR* 
A2000: 28MHz-Takt A2000B: CBR* 

10 +12VDC 36 All 61 Masse 

11 unbelegt 37 Masse 62 BGACK* 


A2000B: CopCFG 
(Configuration Out) 


12 ConfigIn (Masse) 38 AI2 63 D15 
13 Masse 39 A13 64 A500/1000/2000: BG* 
A2000B: CBG* 

14 C3* (3,55 MHz) 40 IPLO* 65 DI14 

15 CDACK (7,.09MHzZ) 41 A14 66 DTACK* 

16 C1* (3,55 MHz) 42 IPLI* 7 DI} 

17 OVR* (für AutoConfig) 43 A15 68 R/W 

18 XRDY (für AutoConfig) 44 IPL2* 69 DI2 

19 INT2* 45 AI6 ‚0 LDS* 

20 A500/2000: Frei 46 DBEER* ’ı Din 


A1000: Palope* 
(für AutoConfig) 
A2000B: BOSS* 
21 A5 47 A17 72 UDS* 
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22 INT6* 48 \VPA* 73 Masse 

23 A6 49 Masse 74 AS* 

24 A4 50 E-Clock 75-84 DO, D10, D1, D9, D2 
D8, D3, D7, D4, D6 

25 Masse 51 VMA* 85 Masse 

26-30 A3/AZ/ATIA1/AB 52 AIB 86 D5 


Auf die einzelnen Signale sind wir ja bereits vorher eingegangen 
(Abschnitt 1.1.1 bis 1.2). Einige sind noch hinzugekommen, die 
speziell für die automatische Einbindung zuständig sind (Auto- 
Configuration). Eine ausführliche Beschreibung würde hier zu weit 
führen, zudem gibt es entsprechende Fachliteratur bzw. Unterlagen 
für Entwickler. Außerdem wird hier der Schwerpunkt auf die 
Program-mierung gesetzt. Diese kurzen Portbeschreibungen sollen 
den Zu-sammenhang des Amiga-Systems etwas verständlicher 
machen. 


Neben dem Expansionsport gibt es noch einen CPU-Steckplatz. Hier 
werden hauptsächlich Turbokarten mit RAM-Erweiterungen eingesetzt. 
Der Amiga 1200 hat einen 150 poligen Stecker an der Unterseite 
vom Gehäuse. Beim A500 ist dieser 56polig. Die Modelle 
A3000/4000 besitzen einen internen 200-Pin-Platinenstecker. 


Prozessorsteckplatz (A500) 
(56poliger Steckplatz) 


PIN __ Funktion PIN __ Funktion 

1-2. +5 Volt 39 WE* 

3-4 Masse 40 unbelegt 

5-20 DObis D15 41-44 XDO bis XD3 (für AKKU-Uhr) 
21-22 Masse 45-48 XA2 bis XA5 (für AKKU-Uhr) 
23-31 AO bis AB 49 XCLKRD* (für AKKU-Uhr) 

32  EXRAM* 50 XCLKWR* (für AKKU-Uhr) 
33-34 Masse 51-52 +5 Volt 

35 CASL* 53-54 Masse 

36 CASU* 55 +12 Volt 

37 unbelegt 56 -12 Volt 

38 RAS* 
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Pr kplatz (A12 
(150poliger Steckplatz) 
Pin _ Funkti Pi F Pin ___Funkti Pin __ Funktion 
1-8 _ reserviert 71-78 D7 bis DO 106 RMC* 130 IOWR* 
9 Masse 79 Masse 107-110 reserviert 131  OE* 
10 +5VDC 80 +5VDC 111 BR* 132 WE” 
11-18 A23 bis Al6 81-83 IPL2-IPLO* 112 BG* 133  OVR* 
19 Masse 84 reserviert 113 reserviert 134  XRDY 
20 +5VDC 85 RST* 114 BOSS* 135 _ZORRO* 
21-28 A15 bis AB 86 HLT* 115 FPUCS* 136 WIDE* 
29 Masse 87-88 reserviert 116 FPUSENSE* 137  INT2* 
30 +5 VDC 89-90 SIZ1/0 117 CCKA 138  INT6* 
31-38 A7 bis AO 91 AS* 118 Reset* 139 Masse 
39 Masse 02 DS* 119 Masse 140 +5VDC 
40 +5VDC 93 R/W 120 +5VDC 141 System1-Masse 
41-48 D31 bis D24 94 BERR* 121 NETCS* 142  SystemO-Masse 
49 Masse 095 reserviert 122 SPARECS* 143  xRxD* 
50 +5VDC 96 AVEC* 123 RTCCS* 144 xTxD* 
51-58 D23 bis DI6 97-98 DSACK1/2* 124 Flash* 145 _Config-Out* 
59 Masse 99 CPUCLKA 125 REG* 146 Audio-Masse 
60 +5VDC 100 E-Clock 126 CCENA* 147  Audio-Left 
61-68 D15 bis D8 101 Masse 127 WAIT* 148 Audio-Right 
69 Masse 102 +5VDC 128 KBRESET* 149 +12VDC 
70 +5VDC 103-105 FC2-FCO 129 IORD* 150  -12VDC 
Pr latz (A3 
(200poliger Steckplatz) 

Pin__ Funktion Pin Funktion Pin Funkti 
1 DWSACKI* 64-65 A7, A16 128 IPL2* 
2-3 Masse 66 SCSI* (A4000) 129 sIz1 

A3000T: Frei 
4 HALT* 67 DMAEN* (A4000) 130-131 Masse 

A3O000T: Frei 
5 R/W 68-69 A24, A17 132 CIIN* 
6-7 Masse 70 reserviert 133 AS* 

A3000T: DIS _CLK3O 
8 BGACK* 71 Masse 134 FPUCS* 
9 SBR* 72-73 A25, A18 135 CPUCLK_ EXP 
10-11 Masse 74-75 Masse 136 OCS* 
12 AVEC* 76-77 A26, A19 137 D31 
13 EXT9O 78-79 reserviert 138-139 Masse 
14-15 +5VDC 80-81 A27, A2O 140-141 D15, D30 
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16 RAMSLOT* 82 

17 BOSS* 83 

18-19 + 5VDC 84-85 

20 FCO 86-87 

21 STERM* 88-89 

22-23 +5VDC 90 

24 FC 91 

25 BR* 92-93 

26-27 +5VDC 94-95 

28 CBACK* 96 

29 BERR* 97 

30 reserviert 98-99 
A3000T: DIS _CLKS 

31 EMUL* 100 

32 CBREQ* 101 

33 A8 102-103 

34 reserviert 104 
A3000T: ECLK3O 

35 Masse 105 

36-37 AO, A9 106-107 

38-39 Masse 108 

40-41 Al, AlO 109 

42 reserviert 110 
A3000T: ECLKYOA 

43 INT6* 111-112 
A3O000T: Frei 

44-45 A2, Al1 113 

46 reserviert 114 
A3000T: ECLKYOA 

47 Masse 115 

48-49 A3, Al2 116 

50-51 Masse 117 

52-53 A4, Al3 118-119 

54 reserviert 120 
A3000T: ECPUCLKB 

55 WAIT* 121 

56-57 A5, Al4 122-123 

58 reserviert 124 
A3000T: ECPUCLKA 

59 Masse 125 

60-61 A6, A15 126 

62-63 Masse 127 


INTI* 


A3000T: Frei 


Masse 
A28, A2] 
Masse 
A29, A22 
reserviert 
DSACKO 
A30, A23 
+5VDC 
A31 

DS’ 
+5VDC 


ES" 
CIOUT* 
+5VDC 
DBEN* 


BG* 
+5VDC 
RMC* 
CPURST* 
FPURST* 


reserviert 


EBCLR* 
reserviert 


Masse 
IPEND* 
RESERT* 
Masse 
IPO* 


SIZO 
Masse 
PLI* 


FC2 


CLK90 EXP 
Masse 
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142-143 


144-145 
146 
147 
148-149 
150 
151 
132-133 
154-155 
156-157 
158 
159 


160-161 
162 
163 
164-165 


166-167 
168-169 
170-171 
172-173 
174-175 


176-177 


178-179 
180-181 


182-183 
184-185 
186-187 
188-189 
190-191 


192-193 
194-195 
196-197 


198-199 
200 


Masse 


D14, D29 
reserviert 
CBR* 
D13, D28 
reserviert 
Masse 
D12,027 
Masse 
D11, D26 
reserviert 
BG30* 


D10, D25 
reserviert 
Masse 
D9, D24 


Masse 
D8, D16 
reserviert 
DO, D17 
+5VDC 


D1, D18 


+5VDC 
D2,D19 


+5VDC 
D3, D20 
+5VDC 
D4, D21 
Masse 


D5, D22 
Masse 
D6, D23 


Masse 
D7 
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1.2.8 Der Zorroll/lil-Bus 


Die besten Möglichkeiten einen Amiga zu Erweitern, bieten die 
Zorro-Steckplätze. Dabei handelt es sich um 100polige Steckerleisten, 
die sich im Inneren des Rechners befinden. Der Amiga 2000 besitzt 5 
Zorroll-Steckplätze, die vertikal angeordnet sind. Die Modelle 
A3000/4000 verfügen über 5 bzw. 4 Zorrolll-Steckplätze (horizontal 
angeordnet). 


Die Bezeichnung "ZORRO" ist auf ein A1000-Prototypenboard 
zurückzuführen. Dieses war das erste Board, bei dem die meisten Er- 
weiterungsspezifikationen funktionierten. Und weil danach Nie- 
manden ein anderer Name einfiel, blieb es bei dieser Bezeichnung. 


Da die ersten Amiga-Modelle "nur" einen 68000er besaßen, wurde 
der Zorroll-Bus auf die Daten eines mit 7 MHz getakteten MC68000 
abgestimmt. Er ist ein rein synchroner Bus, mit dem gleichen 
Zeitverhalten eines MC68000. Damit war der Adreßbereich auf 16 
MByte beschränkt (24-Bit-Adreßbus) und der Datenbus hatte auch nur 
eine Breite von 16-Bit. 


Mit der Einführung des A3000, kam der MC68030 zum Einsatz, ein 
reiner 32-Bit-Prozessor. Aufgrund dessen war der Zorroll-Bus nicht 
mehr zeitgemäß und der Zorrolll-Bus wurde entwickelt. Dieser besitzt 
einen vollen 32-Bit-Adreß- und Datenbus und ist voll 
abwärtskompatibel. Allerdings verrichten nicht alle Zorroll-Karten 
ihren Dienst in Zorrolll-Steckplätzen. Das ist aber nur dann der Fall, 
wenn bestimmte Richtlinien nicht eingehalten wurden, wie z.B. die 
Verwendung von Signalen, die nur für einen bestimmten Zorro- 
Standard gelten (VMA, VPA). Außerdem besitzt der Zorrolll-Bus noch 
eine schnellere Interruptbearbeitung, neue Cache-Signale und einiges 
mehr. Mit anderen Worten, er ist um einiges schneller als der 
Zorroll-Bus. 
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Bus-Systeme gibt es viele auf dem Computersektor. Aber das vom 
Amiga ist besonders leistungsfähig, da der Benutzer sich um nichts zu 
kümmern hat. Einfach die Karte in den Steckplatz setzen, Treiber 
installieren und fertig. Alles andere erledigt die Auto-Configuration 
des Zorroll/Ill-Systems. Beim PC-System ist es notwendig jede Karte 
von Hand zu installieren. Hier muß man Port- und Speicheradressen, 
Interruptnummern und DMA-Kanäle vergeben und eine Abstimmung 
mit der Software vornehmen. 


Der Amiga besitzt ein flexibles, automatisch konfigurierendes System. 
Dafür verfügt jede Karte über ein EPROM- oder ein PAL-Baustein, in 
dem alle notwendigen Informationen für den Auto-Config.-Mode 
enthalten sind. 


Informationen für den Auto-Contig.-Mechanismus: 


1) Hersteller-Kennziffer 


Jeder Entwickler von Zorro-Karten erhält von Commodore bzw. 
Amiga-Technologies eine Kennziffer zugeteilt, über die er seine Karte 
mit der "expansion.library" erkennen kann. 


2) Produktnummer 


Diese Nummer kann vom Hersteller frei gewählt werden und ist 
zusätzlich für die Erkennung über die "expansion.library" erforderlich. 


3) Seriennumer 
Sie kann frei vom Hersteller gewählt werden und kann alles mögliche 
bedeuten (vier Bytes). 


Typ-Bezeichnung und Flags 
Hier stehen Informationen, wie der Zorro-Standart (II/III), die Größe 


des benötigten Adreßraumes und noch einiges mehr. Der Adreßraum 
kann 64 KByte, 128 KByte, 256 KByte, 512 KByte, 1 MByte, 2MByte, 
4 MByte und 8 MByte betragen. Dadurch reserviert das System für 
die Karte nur so viel Speicher, wie erforderlich ist. 
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Außer den oben aufgeführten Informationen gibt es noch einige 
weitere. Genauere Informationen stehen z. B. im Hardware-Reference- 
Manual und/oder im Technical-Reference-Manual. 


Wie funktioniert nun der Auto-Config.-Mechanismus? 


jede Zorro-Karte hat seine eigene Nummer, die sich nach dem 
Steckplatz richtet. Nach einem Reset werden alle Karten der Reihe 
nach über die Signale "CFGIN" und "CFGOUT" abgefragt. Jede Karte 
bekommt einen 64-KByte Informationsblock zugewiesen, der für 
Zorroll ab $OOE8xxxx und für Zorrolll ab $FFOOxxxx liegt. Jetzt 
werden alle nötigen Daten für die Einbindung der Karte in eine 
Systemliste eingetragen. Danach werden die Treiber installiert, die 
über die "expansion.library" alle nötigen Informationen über die 
dazugehörige Karte erhalten, um sie einbinden zu können. 


Bei der Auswahl des Steckplatzes ist zu beachten, daß die Prioritäten 
von rechts nach links bzw. von oben nach unten kleiner werden. Die 
Karte mit der höhsten Priorität bekommt immer als erstes den Bus 
zugeteilt. Auch die Einbindung der Karten erfolgt nach oben 
genannter Reihenfolge. Zu beachten ist auch, daß die Signale immer 
besser werden, je näher die Karte am CPU-Steckplatz liegt (kürzere 
Signalwege). Zudem werden sowieso immer erst die Erweiterungen 
im CPU-Steckplatz eingebunden, weil diese eine noch höhere Priorität 
haben, als die Zorro-Steckplätze. Der Zorro-Standard schreibt 
ebenfalls vor, daß sich die Adresse der Erweiterung immer durch die 
eigene Adreßraumgröße teilen lassen muß. Eine Außnahme bilden 
hier 4 und 8 MByte-Adreßräume, Jene müssen auch auf Adressen 
funktion-ieren, die durch 2 MByte teilbar sind. Dies alles 
berücksichtigt die "expansion.library" und teilt die Adreßräume 
entsprechend ein. 
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Zorroll/Ill-Steckplatz (A2000/3000/4000) 


(100poliger Platinenstecker) 


Pin _Physical-Name Zorroll-Name Zorrolli-Adr.phase _Zorrolll-Datenphase 


1 Masse Masse Masse Masse 

2 Masse Masse Masse Masse 

3 Masse Masse Masse Masse 

4 Masse Masse Masse Masse 

5. +5VDC +5VDC +5VDC +5VDC 
6 +5VDC +5VDC +5VDC +5VDC 

7 OWN* OWN* OWN* OWN* 

8 -5VDC -5VDC -5VDC -5VDC 

9  SLAVEn* SLAVEn* SLAVEn* SLAVEn* 
10 +12VDC + 12VDC + 12VDC + 12VDC 
11  FCGOUTn* CFGOUTn* CFGOUTn* CFGOUTn* 
12 CFGINn* CFGINn* CFGINn* CFGINn* 
13 Masse Masse Masse Masse 

14 C3* C3-Clock* C3-Clock * C3-Clock * 
15 CDAC CDAC-Clock CDAC-Clock CDAC-Clock 
16 1° C1-Clock * C1-Clock* C1-Clock* 
17. CINH* OVR* CINH* CINH* 
18 MTCR* XRDY MTCR* MTCR* 
19 INT2* INT2* INT2* INT2* 
20 -12VDC -12VDC -12VDC -12VDC 
Zi #55 A5 A5 A5 
22 INT6* INT6* INT6* INT6* 
23 A6 Ab A6 A6 
24 A4 A4 A4 A4 
25 Masse Masse Masse Masse 
26 A3 A3 A3 A3 
27 A2 A2 A2 A2 
28 A7 A7 A7 A7 
29 LOCK* Al LOCK * LOCK* 
30 ADB AB AB DO 

31 FCO FCO FCO FCO 

32 AD9Y Ag A9 D1 

33 FC FC1 FC1 FC1 

34 ADIO A1O A1O D2 

35 FC2 FC2 PC2 FG 

36 ADII AlI A11 D3 

37 Masse Masse Masse Masse 

38 ADI2 Al2 Al2 D4 

39 ADI3 A13 A13 D5 
40 reserviert (EINT7*) reserviert reserviert 
41 ADI14 A14 A14 D6 
42 reserviert (EINT5*) reserviert reserviert 
43 ADI15 A15 A15 D7 
44 reserviert (EINT4*) reserviert reserviert 
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AD16 
BERR* 
AD17 
MTACK* 
Masse 
E-Clock 
DSO* 
AD18 
RESET* 
AD19 
HLT* 
AD2O 
AD22 
AD21 
AD23 
BRn* 
Masse 
BGACK* 
AD31 
BGn* 
AD3O 
DTACK* 
AD29 
READ 
AD28 
DS2* 
AD27 
DS3* 
Masse 
LS? 
SDO 
AD26 
SsDI 
AD25 
SD2 
AD24 
SsD3 
SD7 
sD4 
SD6 
Masse 
SD5 
Masse 
Masse 
Masse 
Masse 
SenseZ3 
7M 


regrundlagen 


A16 
BERR* 
A17 
(VPA*) 
Masse 
E-Clock 
(VMA*) 
A18 
RST* 
A19 
HLT* 
A2O 
A22 
A21 
A23 
BRn* 
Masse 
BGACK* 
D15 
BGn* 
D14 
DTACK* 
D13 
READ 
D12 
LDS* 
D11 
UDS* 
Masse 
AS* 


D10 
DI 
DI 
D2 
D8 
D3 


D4 
D6 
Masse 
D5 
Masse 
Masse 
Masse 
Masse 
Masse 
E7M 
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A16 
BERR* 
Al? 


Masse 
E-Clock 
DSO* 
A18 
RESET* 
A19 
HLT* 
A2O 
A22 

A21 

A23 
BRn* 
Masse 
BGACK* 
A31 
BGn* 
A30 
DTACK* 
A29 
READ 
A28 
DS2* 
A27 
DS3* 
Masse 
day, 
reserviert 
A26 
reserviert 
A25 
reserviert 
A24 
reserviert 
reserviert 
reserviert 
reserviert 
Masse 
reserviert 
Masse 
Masse 
Masse 
Masse 
SenseZ3 
7M 


MTACK* 


D8 
BERR* 


MTACK* 
Masse 
E-Clock 
DSO* 
D10 
RESET* 
D11 
HLT® 
D12 
D14 
D13 
D15 
BRn* 
Masse 
BGACK* 
D31 
BGn* 
D30 
DTACK* 
D29 
READ 
D28 
DS2* 
D27 
DJ" 
Masse 
Cc5* 
D16 
D26 
D17 
D25 
D18 
D24 
D19 
D23 
D20 
D22 
Masse 
D21 
Masse 
Masse 
Masse 
Masse 
SenseZ3 
7M 
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903 DOE DOE DOE DOE 

94 IORST* BUSRST* IORST* IORST* 
05 BCLR* CBG* BCLR* BCLR* 
96 reserviert (EINTI*) reserviert reserviert 
97 FCcS* unbelegt ERS” Fir 

98 DSI* unbelegt DS1* DS1* 

909 Masse Masse Masse Masse 
100 Masse Masse Masse Masse 


n = Steckplatznummer 
= lowaktiv 

() = werden Signale in Klammern bei Zorroll-Standard verwendet, ist die 
Kompatibilität zum Zorrolll-BUS nicht mehr gewehrleistet. 


Zum Abschluß noch ein kleines Assemblerlisting, welches einige Infor- 
mationen aus den ersten beiden eingebundenen Karten einließt. Die 
"expansion.library" stellt uns dafür die Funktion "FindConfigDev ()" 
zur Verfügung, welcher wir eine ConfigDev-Struktur in AD übergeben 
müssen. Ab dieser Struktur sucht die Funktion dann alle weiteren 
Einträge nach den gewünschten Werten durch, die wir in DO und D! 
übergeben. Übergeben wir in AO eine Null, so beginnt das System 
eine gerichtete Suche von Beginn der Liste. Zurück bekommen wvir in 
DO eine Null, falls keine passende ConfigDev-Struktur gefunden 
wurde oder die Adresse der Struktur. In DO und D1 müssen wir die 
Hersteller-- und Produktnummer angeben, nach der wir suchen 
wollen. Übergeben wir hier eine -1, so wird die Nummer ignoriert 
und der erste Eintrag wird zurückgegeben. Über diesen Zeiger 
können wir dann den nächsten Eintrag ermitteln. 


Routine: FindConfigDev (A0,DO0,D1) 
(oldConfigDev,Manufacturer,Product) 

Offset: -72 

Library: expansion.library 

Parameter: AD = ConfigDev-Struktur ab der gesucht werden soll oder 
Null, wenn alles durchsucht werden soll. 

Herstellernummer (siehe unten) oder -1 für egal 

Produktnummer oder -1 für egal 


DO 
DI 
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Rückgabe: => DO = ConfigDev-Struktur für passenden Eintrag oder 
Null 

Erklärung: 

Die Funktion durchsucht alle ConfigDev-Strukturen, die zu Beginn für 

jedes Board erzeugt wurden. 


u der ConfigDev-Struktur (Lä = 68B 
Offen T N Funkti 
STRUCT cd Node Node-Struktur (14 Bytes) 
„ B cd Flags Flags (siehe unten) 
15 B cd Pad reserviert 
16 Eee) ExpansionRom Kopie der ersten 16 Bytes des Board-ROMs 
32 cd BoardAddr Adresse des Boards im Speicher 
36 cd BoardSize Adreßraumgröße des Boards 
40° W cd SlotAddr Slotnumber (Nummer des Steckkartenplatz) 
422 W cd SlotSize Anzahl der Steckplätze 
4 L cd _Driver Zeiger auf Treiber-Node-Struktur 
48 L cd_NextCD Adresse der nächsten ConfigDev-Struktur oder Null 
52 STRUCT cd_Unused 16 freie Bytes für beliebige Zwecke 
68 Ende der Struktur 
Bedeutung der Flags: 
Bi F 
0 cd SHUTUP Dieses Board wurde schon eingebunden 
1 cd CONFIGME Dieses Board muß über einem Driver eingebunden werden 
2 cd BADMEMORY Dieses Board beinhaltet Bad-Memory 
3 cd PROCESSED Flag für private Benutzung 


Jedes Board enthält ein ROM von 32 Bytes, die während des Resets 
ausgelesen werden (über ConfigIn/Out-Signale) und entsprechend 
wird dann die Karte eingebunden. Jede Karte (Board) bekommt eine 
ConfigDev-Struktur zugeteilt. Die ersten 16 Bytes werden als 
ExpansionRom-Struktur bezeichnet (Aufbau siehe unten), die zweiten 
16 Bytes enthalten die ExpansionControl-Struktur. Sie enthält bisher 
nur vier Einträge, auf die wir hier nicht weiter eingehen wollen. 
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ExpansionRom-Struktur (Länge = 16 Bytes) 


Offset T Name Funktion 

00 B er Type Board-Type (s. entsprechende Fachliteratur) 

01 B er Product Produktnummer des Herstellers 

02 B er Flags Flags (enthält unter anderem die Adreßgröße) 

03 B er ReservedO3 reserviert (muß Null sein) 

04 W er Manufacturer spezielle Nummer, die von AT bzw. Commodore 
vergeben wird 

06 L er SerialNumber Seriennummer vom Hersteller 

10 W er _InitDiagVec Offset zu einer DiagArea-Struktur oder Null 

12 B er ReservedOc die folgenden 

a 8 er ReservedOd Bytes sind 

14 B er ReservedOe reserviert für 

3 8 er ReservedOf spätere Erweiterungen 

16 Ende der Struktur 


;-—-- Ließt die Herstellernummern der ersten beiden Boards ---- 
;--- und gibt diese in DO und DI zurück ---- 


' 


lea ExpansionName,al 

moveq #0,d0 

move.|l 4,36 

jsr -552(a6) ; OpenLibrary () 

move.|l dO,ExpansionBase 

beq Ende 

sub.| a0,a0 ; Start vom Anfang 
movegqg #-1,d0 ; Herstellernummer egal 
moveqg #-1,d1 ; Productnummer egal 
move.|l ExpansionBase,a6 

jsr -72(a6) ; FindConfigDev () 

tst.| dO 

beq Ende 

move.l dO,a0 ; ConfigDev-Struktur 
move.w 16+4(a0),M ID] ; Herstellernummer vom 1. Board 
movegq #-1,d0 

movegq #-1,dl 

move.l ExpansionBase,a6 

jsr -72(a6) ; FindConfigDev () 
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tst..| do 
beq Ende 
move.w 16+4(a0),M ID2 ; Herstellernummer vom 2. Board 
Ende: 
move.|l ExpansionBase,dO 
beq Ende_2 
move.l dQ,al 
move.|l 4,36 
jsr -414(a6) ; CloseLibrary () 
Ende 2: 
moveq #0,d0 
moveq #0,d1 
move.w M ID1,d0 ; Herstellernummer vom 1. Board nach DO 
move.w M _ID2,d1 ; Herstellernummer vom 2. Board nach DI] 
rts ; Prg.Ende 


ExpansionName: dc.b "expansion.library",O 
even 

ExpansionBase: dc.| O 

M_ID1: dc.w O 

M ID2: dc.w O 
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1.2.9 Der IDE-/SCSI-Controller 


Lange Zeit war das Diskettenlaufwerk das Medium zum Speichern 
von Daten. In den Anfangszeiten galt die Kapazität von knapp 1 
MByte pro Diskette als völlig ausreichend und die Geschwindigkeit als 
akzeptabel. Mittlerweile kann man nur noch darüber schmunzeln. Es 
mußten andere Speichermedien gefunden werden. Für die heutige 
Zeit sind Festplatten noch die günstigste Möglichkeit Daten zu 
speichern. Doch die Entwicklung schreitet immer weiter voran. Die 
Kapazität wird immer größer und die Übertragung immer schneller. 


Im Amiga werden IDE- und SCSI-Schnittstellen eingesetzt. Die IDE- 
Schnittstelle ist die günstigste Variante in Bezug auf das Preis/ 
Leistungsverhältnis. Die IDE-Norm läßt maximal zwei Festplatten 
(Master/ Slave), aber auch nur Festplatten an einer Schnittstelle zu. 
Die Daten werden parallel und byteweise (8 Bit) übertragen. Die 
Geschwindigkeit liegt um einiges hinter den SCSI-Platten. Dafür sind 
die Anschaffungskosten ungefähr halb so hoch, wie bei den SCSI- 
Festplatten. Mittlerweile wurde der IDE-Standard erweitert und nennt 
sich jetzt E-IDE (Enhanced-IDE). Hier wurde die Übertragungszeit 
erheblich gesteigert und es können bis zu vier Geräte an maximal 
zwei Controllern betrieben werden. Der Amiga 600/1200/4000 hat 
bereits eine IDE-Schnittstelle integriert. Beim A1200/600 handelt es 
sich um einen 2,5 Zoll-Anschluß (44polig). Es gibt bereits Adapter, 
die die Verbindung zu 3,5 Zoll-Festplatten ermöglichen. Diese sind 
um einiges billiger und schneller, verbrauchen aber mehr Strom, was 
zu Problemen führen könnte. Auch E-IDE-Platten können an IDE- 
Schnittstellen betrieben werden. Die Geschwindigkeit liegt dann etwa 
1,5 bis 2 mal so hoch wie bei IDE-Platten. Ich persöhnlich betreibe 
eine 3,5 Zoll E-IDE-Platte mit einer Kapazität von 1,2 GByte über 
einen Adapter an der internen IDE-Schnittstelle des A1200 (mit 
eingebauter 68030/28MHz-Turbokarte +4MByte 32-Bit-Fast-RAM). 
Da es sich bei der internen IDE-Schnittstelle um eine Mischung aus 
SCSI und IDE/AT handelt, komme ich auf eine Übertragungsrate von 
ca. 2 MByte pro Sekunde. Von solchen Werten träumen PC-User nur. 
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Der A3000 besitzt von Haus aus eine SCSI-Schnittstelle. Anfang der 
80er Jahre wurde der SCSI-1-Standard definiert (SCSI=Small- 
Computer-Systems-Interface). Für Speicher mit wahlfreiem Zugriff 
(Festplatten) wurde ein Mindestbefehlssatz (Common-Command-Set) 
ausgearbeitet, um auf einfache Weise mit einem SCSI-Gerät kom- 
munizieren zu können. Allerdings unterstützten nicht alle Hersteller 
diesen Befehlssatz. Mitte der 80er wurde dann der SCSI-Il-Standard 
verabschiedet, bei dem das Common-Command-Set, kurz (CS, 
implementiert wurde. Duch diesen Befehlssatz können alle 
erdenklichen Arten von Peripherie (Festplatte, Scanner, Streamer etc.) 
betrieben werden. Man benötigte nur einen SCSI-Treiber, der die 
Geräte über diesen Befehlssatz ansteuert, da ja keine genauen 
Kenntnisse über das einzelne Gerät notwendig waren. Über die SCSI- 
Schnittstelle können maximal 8 Geräte betrieben werden. Die Geräte 
werden als "Initiator" oder als "Target" bezeichnet, je nachdem ob 
sie der Auslöser (Initiator) oder das Ziel (Target) einer Operation sind. 


Jedes Gerät bekommt eine Nummer zwischen O und 7 zugeteilt (über 
Jumper). Die Adresse 7 hat dabei die höchste Priorität. Genauge- 
nommen können nur max. 7 Geräte betrieben werden, da eine 
Adresse für den HOST-Adapter reserviert ist. Dieser stellt über ein 
5SOpoliges (oder 25) Flachbandkabel die Verbindung zum SCSI-Bus 
her. Da bei SCSI-Geräten der Controller bereits integriert ist, sind sie 
in der Lage selbständig Funktionen auszuführen, ohne die CPU zu 
beanspruchen. Der Computer erteilt einmal die erforderlichen Befehle 
aus der CCS-Liste und den Rest übernimmt das SCSI-Gerät. 


Beim Anschluß von Geräten ist darauf zu achten, daß das Kabel 
normalerweise nur max. 6 Meter lang sein darf und daß das Gerät 
direkt über einen Stecker an das Flachbandkabel angeschlossen wird 
(keine Abzweigung). Das jeweils letzte Gerät muß über einen Wider- 
stand terminiert werden (aktiv oder passiv). 
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Bei SCSI-Peripherie werden gleichfalls nur 8-Bit parallel übertragen, 
jedoch wesentlich schneller als bei IDE-Geräten. Die Entwicklung ist 
natürlich auch hier nicht stehen geblieben. Es gibt mittlerweile noch 
die FAST-SCSI-Norm, bei der die Taktfrequenz verdoppelt und die 
WIDE-SCSI-Norm, bei der die Datenbreite erhöht wurde (16/32-Bit). 
Für die Fast-SCSI-Norm sind komplizierte zusätzliche Schaltungen 
notwendig und bei WIDE-SCSI ist ein 68poliges Kabel notwendig. 


SCSI-Befehle (Common-Command-Set) 


HEX_ Name 

00 TestUnitReady 
O1 Rezero Unit 

03 Request Sense 
04 Format Unit 

07 ReAssign Block 
08 Read 

OA Write 

OB Seek 

12 Inquiry 

15 Mode Select 

16 Reserve Unit 

17 Reserve 

18 Copy 

1A Mode Sense 

1B Start/Stop Unit 
1C Receive Diagnostic Results 
1D Send Diagnostics 
25 Read Capacity 
28 Read (Extended) 
2A Write (Extended) 
2B Seek (Exetended) 
2E Write and Verify 
2F Verify 

37 ReadDefectList 
3B WriteBuffer 

3C ReadBuffer 

3E Readlong 

3F Writelong 


Funktion 

Betriebsbereitschaft des Gerätes feststellen 

Köpfe auf Spur Null fahren 

Fehlerstatus anfordern 

Gerät formatieren 

defekten Block makieren 

Daten einlesen vom Gerät 

Daten speichern auf Gerät 

logischen Block ansteuern 

Informationen über logische Unit abfragen 

Gerät konfigurieren 

Gerät (LUN) sperren für andere Auslöser 

Gerät (LUN) wieder freigeben 

Daten kopieren 

Gerätekonfiguration einlesen 

Geräte freigeben/sperren 

Selbsttestergebnisse einlesen 

Selbsttest starten 

Plattenkapazität auslesen 

wie Read, aber mit erweiterter Adresse 

wie Write, aber mit erweiterter Adresse 

wie Seek, aber mit erweiterter Adresse 

Daten schreiben und überprüfen 

gespeicherte Daten überprüfen 

Liste der defekte Sektoren lesen 

Datenpuffer schreiben 

Datenpuffer einlesen 

Datenblock einlesen (512 Bytes)+ ECC 
Datenblock speichern (512 Bytes) + ECC 
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interne _SCSI-Schnittstelle (A3000) 
(5Opolige Verbindung) 
Pin Funktion Pin Funktion 
2 DataO 28 Masse 
4 Data] 30 Masse 
6 Data2 32 ATN* 
8 Data3 34 NC 
10 Data4 36 BSY 
12 Data5 38 ACK* 
14 Data6 40 RST* 
16 Data? 42 MSG* 
18 Parity 44 SsEL* 
20 Masse 46 UD 
22 Masse 48 RE()* 
24 Masse 50 /O 
26 TerminationPower 
- alle ungeraden Pins liegen auf Masse 
- Pin 25 ist offen 
externe SCSI-Schnittstelle (A3000) 
(SUB-D 25-Pin/weiblich) 

Pin Funktion Pin Funktion __ Pin Funktion 
1 REQ 10 Data3 19 Sel* 
2 MSG* 11 Data5 20 Parity 
3 VO 12 Data6 21 Datal 
4 RST* 13 Data? 22 Data2 
5 ACK* 14 Masse 23 Data4 
B: BSY> 3 “BD 24 Masse 
7 Masse 16 Masse 25 Termination Power 
8 DataO 17 ATN* 

9 Masse 18 Masse 
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Weitere Informationen zum Amiga spezifischen SCSI-Device finden Sie 
im Kapitel 6. Dort wird die Programmierung von SCSI-Peripherie, 
insbesondere Festplatten, demonstriert. 


1.2.10 Der PCMCIA-Port 


Der PCMCIA-Port ist ein 68poliger Steckplatz für kreditkartenförmige 
Erweiterungskarten. PCMCIA steht für "Personal-Computer-Memory- 
Card-International-Association". Hierbei handelt es sich um eine Her- 
stellervereinigung, die sich bereits 1990 auf eine einheitliche, 
mechanische und elektrische Schnittstelle für Memory-Karten einigten 
(PCMCIA Release 1.0). Ursprünglich nur für beliebige Memory- 
Erweiterungen gedacht (RAM, ROM, EPROM etc.), wurde wenig 
später die PCMCIA-Norm erweitert (PCMCIA Release 2.0). Jetzt 
können auch andere Erweiterungen, wie Faxgeräte, Grafikkarten, 
SCSI-Controller usw. angeschlossen werden. 


Die Modelle A600/A1200 sind bisher die einzigen Amiga-Rechner, 
die serienmäßig mit einem solchen Steckplatz ausgestattet sind. 
Hinweise wie die PCMCIA-Karten eingebunden werden, findet man 
im Benutzer- bzw. Workbench-Handbuch. Über das Hilfsprogramm 
"PrepCard" werden Speicherkarten als RAM oder Diskettenlaufwerk 
eingerichtet. Für andere Erweiterungen werden alle erforderlichen 
Treiber vom Hersteller mitgeliefert. 
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1.3 Speicherbelegung 


Wie bereits mehrmals erwähnt, fiel der Begriff "Speicher". Der 
"normale" Speicher wird als sogenanntes RAM bezeichnet (Random 
Access Memory). In einem RAM können Informationen hineinge- 
schrieben bzw. ausgelesen werden. Die Informationen gehen 
allerdings bei Stromausfall verloren, da es sich um einen flüchtigen 
Speicher handelt. Beim AMIGA gibt es drei Arten von RAM- 
Speichern. Einmal das FAST-RAM, auf das nur der Prozessor zugreifen 
kann, das oben beschriebene CHIP-RAM, auf das der Prozessor und 
die Co-Prozessoren (Custom-Chips) zugreifen können und als letztes 
das Slow-RAM. Beim Slow-RAM, kann der Prozessor in höheren 
Grafikauflösungen durch die Co-Prozessoren gebremst werden. Sie 
werden sich sicherlich nach der Bedeutung des Slow-RAM fragen, da 
es doch auf dem ersten Blick nur Nachteile bringt. Der Grund für die 
Existenz, lag damals in der kostengünstigeren Herstellung. Erhielt 
man doch für den Amiga 500 eine interne 512 KByte Speicherer- 
weiterung (Slow-RAM) für ca. 60 DM. Eine vergleichbare Externe 
(FAST- RAM) kostetete 1992 ca. 200 DM. 


Einen Computer nur mit RAM-Bausteinen auszurüsten, würde natür- 
lich nicht funktionieren. Denn einmal ausgeschaltet wären alle Daten 
verloren. Damit der Computer beim Einschalten auch immer das Glei- 
che macht, wird ein Betriebssystem auf ein ROM-Baustein gebrannt. 
Ein ROM-Baustein (Read Only Memory) kann nur gelesen werden. 
Die Informationen sind fest eingebrandt und können nicht mehr ver- 
loren gehen bzw. gelöscht werden. 


Es gibt noch weitere Arten, auf die wir hier allerdings nicht näher 
eingehen wollen, da es nicht erforderlich ist. 
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Alle Amigamodelle haben prinzipiell die gleiche Speicherbelegung. 
Wie Groß der maximale Speicher ist, hängt vom Prozessor ab. 
Rechner mit einer 68000- bzw. 60ECO2O-CPU sind nicht in der Lage 
den vollen Adreßraum zu nutzen, bedingt durch die zu geringe 
Anzahl der Adreßleitungen. Alle anderen Prozessoren können auf den 
gesamten Adreßbereich zugreifen. Wie nun dieser Bereich aufgeteilt 
ist, zeigt folgende Tabelle. 


Adresse (von-bis Funktion 

$00000000-$001FFFFF CHIP-RAM-Bereich (max. 2MByte) 

$00200000-$009FFFFF Zorroll-Erweiterungsadreßraum bzw. max. 8 MByte FAST-RAM 

(#00200000-$005FFFFF) 4-MByte 32-Bit-FAST-RAM 

(#00600000-$009FFFFF) 4-MByte Common-Memory (für PCMCIA-RAM-Karten) 

$00A00000-$00B7FFFF Adreßraum für Zorroll I/O-Karten (1,5 MByte für Erweiterung- 
en auf der Mutterplatine) 

$00B80000-$00BFCFFF reserviert für spätere I/O-Register (LOW-Adreßraum) 

$00BFDOO0-$0OBFDFOO CIA-B-Adressen (in $100-Schritten u. auf gerade Adressen) 

$00BFEOOI-$OOBFEFO1 CIA-A-Adressen (in $100-Schritten u. auf ungerade Adressen) 

$00C00000-$00C7FFFF 512-KByte Erweiterungsspeicher (Ranger Memory) 

H00C80000-$00D7FFFF 1-MByte Erweiterungsspeicher (A500/A2000) 

$00D80000-$00DBFFFF reserviert 

$00DCO000-$00DCFFFF 64-KByte für Echtzeituhr 

$00DDO000-$00DDFFFF SCSI-Kontroll-Speicher (64 KByte) 

$00DEO000-$0OODEFFFF Motherboard-Resources (64 KByte) 

$0ODFOO000-$0OODFFFFF Adreßbereich für Custom-Chip-Register (64 KByte) 

$00E00000-$00E7FFFF reserviert (512 KByte) 

$00E80000-$00EFFFFF Zorroll I/O-Auto-Configuration-Adreßraum (64 KByte-Blöcke) 

$OOFO0O000-$00OF7FFFF Diagnostic-ROM (reserviert) 

$00F80000-$00OFFFFFF High-ROM (512 KByte) => Für A500/2000 von 
$00FCO000-$0OFFFFFF (256 KByte-ROM) 

$01000000-$03FFFFFF reserviert 

$04000000-$0O7FFFFFF FAST-RAM für Motherboard 

$08000000-$0FFFFFFF Adreßbereich für Coprozessor-Erweiterungen 

$10000000-$7FFFFFFF Zorrolll-Erweiterungsadreßraum bzw. Zorrolll-FAST-RAM 

$80000000-$FEFFFFFF reserviert 

$FFOO0000-$FFOOFFFF Zorrolll I/O-Auto-Configuration-Adreßraum 

$FFO10000-$FFFFFFFF reserviert 


Außer den eben aufgezählten Speicherbausteinen, gibt es noch eine 
Speicherart, die irgendwo dazwischen liegt (eher zu den RAMSs zählt). 
Es handelt sich dabei um die Hardwareregister. Diese sind Speicher- 
zellen, welche die Verbindung zu den verschiedenen Hardwarebau- 
Steinen (Agnus, Paula etc.) herstellen und diese mit den erforder- 
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lichen Informationen "füttern". Erst durch die Hardwareregister ist 
der "Computer" in der Lage zur Flexibilität (verschiedene Auf- 
lösungen, etc.). Die Adressen und Programmierung der Register 
werden in den nächsten Kapiteln beschrieben. 


jedes dieser Register ist entweder 8 oder 16 Bit breit. Einige sind 
auch über zwei 16 Bit- Speicherzellen verteilt. Eine Speicherzelle von 
8 Bit bezeichnet man auch als ein Byte, zwei Bytes (16 Bit) als Word 
und 4 Bytes (32 Bit) als Longword. 


Hier folgt eine Auflistung der Customregister mit der dazugehörigen 
Adresse, wo es im Speicher zu finden ist. Ausführlich werden einige 
Register in den nachfolgenden Kapiteln beschrieben. 


Jedes Register ist ein Word (16 Bit) breit und liegt immer auf einer 
geraden Adresse. Die Basisadresse aller Register ist $DFFOOO. Die ab- 
solute Adresse errechnet sich wie folgt: 


Adresse = Basisadresse + Adressoffset 
z.B. $dff000 + $180 = $dAff180 => ColorO-Register 


Erklärung der Abkürzungen: 


Adr = Adressoffset (hexadecimal) 

r = nur Leseregister 

w = nur Schreibregister 

er = early read (DMA-Ausgaberegister) 

S = strobe (ein beliebiger Zugriff löst ein Ereignis aus) 

A = Register im Agnus-Chip 

D = Register im Denise-Chip 

p = Register im Paula-Chip 

p = Register wird vom Copper/Prozessor benutzt 

d = Register wird vom DMA-Controller benutzt 

E = geänderte Registerbelegung im ECS 

UHRES = doppelte Horizontalfrequence (31,4 KHz, statt 15,7 KHz) 
SHRES = Modus mit doppelter Anzahl Bildpunkten pro Zeile 
HSYNC = horizontales Synchronisationssignal am Ende jeder Zeile 
VSYNC = vertiakles Synchronisationssignal am Ende jedes Bildes 
PAL = europ. Fernsehnorm mit 312 Bildzeilen (625 Interlace) 
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Name 
BLTDDAT 
DMACONR 
VPOSR 
VHPOSR 
DSKDATR 
JoyO0Dat 
JoylDat 
CLXDAT 
ADKCONR 
POTODAT 
POT1DAT 
POTGOR 
SERDATR 
DSKBYTR 
INTENAR 
INTREQR 
DSKPTH 
DSKPTL 
DSKLEN 
DSKDAT 
REFPTR 
VPOSW 
VHPOSW 
COPCON 
SERDAT 
SERPER 
POTGO 
JOYTEST 
STREQU 
STRVBL 
STRHOR 
STRLONG 


000 
002 
004 
006 
008 
00A 
00C 
00E 
010 
012 
014 
016 
018 
01A 
olC 
0lE 
020 
022 
024 
026 
028 
02A 
02C 
02E 
030 
032 
034 
036 
038 
03A 
03C 
03E 


KhNRKRO 
KR 


® 
R 


RU RK ES EEK EZ ZEZEEZEH HRG HUHN DE RM NMMN 


Adr. r/w 


1 


3 


- 


- 
- 


Org 


- 


OO UVP’ U UVP PU I UUUUUUOU UDO WPD u » 
I URADU DU OU HU TAÄDTUTO HU UT OUVTVTO HH HUT TUT TU NAT FHrg Mu 
"Oo 


- - - - - - 
- 


- 
- 


30 


- 


- 


- - - - - - - - - - . - - 
- 


- 
- 


no 


- 


Funktion 

Blitter Ausgabedaten (Blitter nach RAM) 
DMA-Controllregister lesen 
höchstwertiges Positionsbit (vertikal) 
vertikale u. horizontale Strahlposition 


Diskdaten (Disk nach RAM) 
Joystick- Mausposition (Gameport 0) 
Joystick- Mausposition (Gameport 1) 


Collisionsregister (Sprites) 

Adio- Diskkontrollregister lesen 
Potentiometer Gameport 0 lesen 
Potentiometer Gameport 1 lesen 
Potentiommeter Port (Daten lesen) 
Seriellen Datenport und Status lesen 
Diskettendatenbyte und Status lesen 
mögliche Interrutps-Bits lesen 
empfangene Interrupts-Bits lesen 

Disk DMA-Adresse Bits 16-18 (ECS 16-20) 
Disk DMA-Adresse Bits 0-15 

Disk DMA-Datenlänge in words 

Disk DMA-Datenwordpuffer (RAM <=> Disk) 
Refresh-Zähler 

höhstwertiges Bit, vertikale Strahlpos. 
vertikale/horizontale Strahlpos. setzen 
Copper-Kontrollregister 

Serielle Daten und Stopbits schreiben 
Serielles Portkontrollreg. u. Baudrate 
Pot.-Port Daten u. Startbit schreiben 
In beide Gameports schreiben 

horiz. Sync. mit VertB. u. Equal Frame 
horiz. Synchronisation mit Vert .Blank 
horizontales Synchronisationssignal 
Kennzeichnung einer langen horiz. Zeile 


Die folgenden Register können vom Copper angesprochen werden, 
wenn COPCON = 1 ist. Beim ECS können alle ab hier folgenden Re- 
gister in jedem Fall benutzt werden. 


Name 

BLTCONO 
BLTCONI1 
BLTAFWM 
BLTALWM 
BLTCPTH 
BLTCPTL 


040 
042 
044 
046 
048 
04A 


" 


Ei E—€ 


w Chi Funktion 


A,p 
A,E,p 


Blitterkontrollregister 0 
Blitterkontrollregister 1 

Blittermaske v. 1. Datenword (Quelle A) 
Blittermaske letztes Datenword (A) 
Adresse Quelle C Bits 16-18 


Adresse Quelle C Bits 0-15 
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BLTBPTH 
BLTBPTL 
BLTAPTH 
BLTAPTL 
BLTDPTH 
BLTDPTL 
BLTSIZE 


BLTCONOL 
BLTSIZEV 
BLTSIZEH 


BLTCMOD 
BLTBMOD 
BLTAMOD 
BLTDMOD 


BLTCDAT 
BLTBDAT 
BLTADAT 


DENISEID 


DSKSYNC 


04C 
04E 
050 
052 
054 
056 
058 
05A 
05C 
05E 
060 
062 
064 
066 
068 
06A 
06C 
06E 
070 
072 
074 
076 
078 
07A 
07C 
07E 


zZ EEE SEES ESESEELE <S 


z 


= 


3 - - - - 
- 


- 


u'o'o 


- 


Bee ee 
Vyovrvuonmmou u Do MO oO 


- 


> >>» 
tg n. nn 
2 00 oO 


gu Oo 
o 2 


’ 


Adresse 
Adresse 
Adresse 
Adresse 
Adresse 
Adresse 
Startbl 
Kontrol 


Blitterfensterhöhe 
Blitterfensterbreite u. Startblit 


Quelle 
Quelle 
Quelle 
Quelle 
Ziel D 
Ziel D 
it u, 
lreg. 0 


B Bits 16-18 
B Bits 0-15 
A Bits 16-18 
A Bits 0-15 
Bits 16-18 
Bits 0-15 


(ECS 16-20) 


Größe des Blitterfensters 


Minterms setzen (ECS) 
(ECS) 
(ECS) 


Blitter Modulo für Quelle C 
Blitter Modulo für Quelle B 
Blitter Modulo für Quelle A 
Blitter Modulo für Ziel D 

Frei für Erweiterugen 

Frei für Erweiterugen 

Frei für Erweiterugen 

Frei für Erweiterugen 
Blitter-Datenregister Quelle C 
Blitter-Datenregister Quelle B 
Blitter-Datenregister Quelle A 
Frei für Erweiterungen 

Uhres DMA-Spriteadr. und Data ID (ECS) 
Frei für Erweiterungen 


Revisionsnummer des Denise-Chip 


(ECS) 


Disk-Synchronisationsmuster 


Die folgenden Register können in jedem Fall vom Copper beschrie- 
ben werden. 


Name Adr. r/w Chip Funktion 


COP1LCH 
COPILCL 
COP2LCH 
COP2LCL 
COPJMP1 
COPJMP2 
COPINS 

DIWSTRT 
DIWSTOP 
DDFSTRT 
DDFSTOP 
DMACON 

CLXCON 


080 
082 
084 
086 
088 
08A 
08C 
0O8E 
090 
092 
094 
096 
098 


w 


EEE ESEEBD SS —E 


tg 
"Oo 


‘ 


oo 


- 


. - 


gmBBpmmD mm 2 20 
Oy,OU UDO AUTO m mM'O 


- 


1. Copperlistadr Bits 16-18 
Copperlistadr. Bits 0-15 
Copperlistadr Bits 16-18 
Copperlistadr. 
Copperlist starten 


NV H- 


(ECS 16-20) 


(ECS 16-20) 
Bits 0-15 


2. Copperlist starten 
Copper-Befehlsregister 
linke Ecke des Anzeigefensters 


Obere, 
Untere, 


rechte 


Ecke des Anzeigefensters 


Start des horizontalen Bitplane-DMAs 
Ende des horizontalen Bitplane-DMAs 


‚P,p DMA-Kontrollregister schreiben 


Sprite-Collisionsregister schreiben 
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Har 


INTENA 
INTREQ 
ADKCON 
AUDOLCH 
AUDOLCL 
AUDOLEN 
AUDOPER 
AUDOVOL 
AUDODAT 


AUD1LCH 
AUDILCL 
AUDILEN 
AUDI1PER 
AUDI1VOL 
AUDI1DAT 


AUD2LCH 
AUD2LCL 
AUD2LEN 
AUD2PER 
AUD2VOL 
AUD2DAT 


AUD3LCH 
AUD3LCL 
AUD3LEN 
AUD3PER 
AUD3VOL 
AUD3DAT 


BPLIPTH 
BPLIPTL 
BPL2PTH 
BPL2PTL 
BPL3PTH 
BPL3PTL 
BPL4PTH 
BPL4PTL 
BPLSPTH 
BPL5SPTL 
BPL&PTH 
BPL6PTL 


ar 


09A 
09C 
09E 
OAO 
0A2 
0A4 
0A6 
OA8 
OAA 
0OAC 
OAE 
OBO 
0B2 
0B4 
OB6& 
0B8 
OBA 
OBC 
OBE 
0CO 
0C2 
0Cc4 
0C6 
0C8 
0CA 
occ 
OCE 
0DO 
0D2 
0D4 
0D6 
0D8 
0DA 
ODC 
ODE 
0OEO 
0E2 
0E4 
0E6 
0OE8 
OEA 
OEC 
OEE 
OFO 
OF2 
oF4 
OF6& 


rundlagen 


EEE EX Es cz —E zz EEE ERS SS 


EEE SS EX 


EEK ES EEE EEE 


DuuwuBan 9 © 
AAO m U HO'O 'O 


oO 


- 


- - 
- 


“ 


- 


- 


oDouovuond»>» 
AT HOT DO 


“ - - 
- 


- 


- 


Bug md >» 
20 mo oo 


“ 


"Oo 


- 


“ 


- - - - “ 


- 


- - - . 


>>»>p>>>>>>> > >» 
GG ODGBIUUBR 


- 


Mögliche Inerrupts setzen 
Interrupt request schreiben 


Audio, Disk UART Kontrollregister 
Adiodatenadr. Bits 16-18 (ECS 16-20) 
Kanal 0 Bits 0-15 


Länge der Audiodaten von Kanal 0 
Periodendauer Kanal 0 

Lautstärke Kanal 0 

Audiodaten Kanal 0 (zum D/A-Wandler) 
Frei für Erweiterungen 

Frei für Erweiterungen 
Adiodatenadr. Bits 16-18 

Kanal 1 Bits 0-15 

Länge der Audiodaten von Kanal 1 
Periodendauer Kanal 1 

Lautstärke Kanal 1 

Audiodaten Kanal 1 (zum D/A-Wandler) 
Frei für Erweiterungen 

Frei für Erweiterungen 
Adiodatenadr. Bits 16-18 

Kanal 2 Bits 0-15 

Länge der Audiodaten von Kanal 2 
Periodendauer Kanal 2 

Lautstärke Kanal 2 

Audiodaten Kanal 2 (zum D/A-Wandler) 
Frei für Erweiterungen 

Frei für Erweiterungen 
Adiodatenadr. Bits 16-18 

Kanal 3 Bits 0-15 

Länge der Audiodaten von Kanal 3 
Periodendauer Kanal 3 

Lautstärke Kanal 3 

Audiodaten Kanal 3 (zum D/A-Wandler) 
Frei für Erweiterungen 

Frei für Erweiterungen 


Adresse von Bitplane 1 (Bits 16-18) 
Adresse von Bitplane 1 (Bits 0-15) 
Adresse von Bitplane 2 (Bits 16-18) 
Adresse von Bitplane 2 (Bits 0-15) 
Adresse von Bitplane 3 (Bits 16-18) 
Adresse von Bitplane 3 (Bits 0-15) 
Adresse von Bitplane 4 (Bits 16-18) 
Adresse von Bitplane 4 (Bits 0-15) 
Adresse von Bitplane 5 (Bits 16-18) 
Adresse von Bitplane 5 (Bits 0-15) 
Adresse von Bitplane 6 (Bits 16-18) 
Adresse von Bitplane 6 (Bits 0-15) 


Frei für Erweiterungen 
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BPLCONO 
BPLCONI1 
BPLCON2 
BPLCON3 
BPLIMOD 
BPL2MOD 


—_—— en 


BPL1IDAT 
BPL2DAT 
BPL3DAT 
BPL4DAT 
BPL5SDAT 
BPL6DAT 


_——— en 


SPROPTH 
SPROPTL 
SPRIPTH 
SPRIPTL 
SPR2PTH 
SPR2PTL 
SPR3PTH 
SPR3PTL 
SPRAPTH 
SPRAPTL 
SPR5SPTH 
SPR5SPTL 
SPR6PTH 
SPR6PTL 
SPR7PTH 
SPR7PTL 
SPROPOS 
SPROCTL 
SPRODATA 
SPRODATB 
SPR1POS 
SPRICTL 
SPRIDATA 
SPR1DATB 
SPR2POS 
SPR2CTL 
SPR2DATA 
SPR2DATB 
SPR3POS 


zE DS ELLE 


KLEE Egg 


KEK ESEL ER ES ESEL T LESS ES LESS 


Frei für Erweiterungen 

Frei für Erweiterungen 

Frei für Erweiterungen 
D,E,p Bitplane-Kontrollregister 0 
p Bitplane-Kontrollreg. 1 (Scrollwerte) 
‚E,p Bitplane-Kontrollreg. 2 (Priorität) 
E,p Bitplane-Kontrollreg. 3 (ECS) 
p Bitplane-Modulo für ungerade Bitmaps 
p Bitplane-Modulo für gerade Bitmaps 
Frei für Erweiterungen 
Frei für Erweiterungen 
d Biplane Daten (zum RGB-Ausgang) 
d Biplane 2 Daten (zum RGB-Ausgang) 
‚d Biplane Daten (zum RGB-Ausgang) 
d Biplane Daten (zum RGB-Ausgang) 
d Biplane Daten (zum RGB-Ausgang) 
d Biplane 6 Daten (zum RGB-Ausgang) 
Frei für Erweiterungen 
Frei für Erweiterungen 


au wkb + 


; Spritedatenadresse 0 (Bits 16-18) 
; Spritedatenadresse 0 (Bits 0-15) 
‚ Spritedatenadresse 1 (Bits 16-18) 
‚ Spritedatenadresse 1 (Bits 0-15) 
: Spritedatenadresse 2 (Bits 16-18) 
ı Spritedatenadresse 2 (Bits 0-15) 
i Spritedatenadresse 3 (Bits 16-18) 
; Spritedatenadresse 3 (Bits 0-15) 
e Spritedatenadresse 4 (Bits 16-18) 
; Spritedatenadresse 4 (Bits 0-15) 
; Spritedatenadresse 5 (Bits 16-18) 
; Spritedatenadresse 5 (Bits 0-15) 
: Spritedatenadresse 6 (Bits 16-18) 
; Spritedatenadresse 6 (Bits 0-15) 
; Spritedatenadresse 7 (Bits 16-18) 
: Spritedatenadresse 7 (Bits 0-15) 


- 


‚p,d Spritestartpos. 0 (vert. u. horiz.) 

‚d,p Spritekontrollreg. 0 u. vert. Stop 
Sprite 0 Datenreg. A (zum RGB-Ausgang) 
Sprite 0 Datenreg. B (zum RGB-Ausgang) 

‚d Spritestartpos. 1 (vert. u. horiz.) 

p Spritekontrollreg. 1 u. vert. Stop 


pP 
E 
pP 
P 
P 
d 
‚p Sprite 1 Datenreg. A (zum RGB-Ausgang) 
P 
P 
d 
P 
pP 
P 


‘ 
’ 


- - - 


UTRAROIIARIT OU AAUOU U DT DU UU UT DOD UDO "U 


‘ 


- 


' 


- 


‘ ’ 


- 


Sprite 1 Datenreg. B (zum RGB-Ausgang) 
‚d Spritestartpos. 2 (vert. u. horiz.) 
‚p Spritekontrollreg. 2 u. vert. Stop 

Sprite 2 Datenreg. A (zum RGB-Ausgang) 

Sprite 2 Datenreg. B (zum RGB-Ausgang) 
‚d Spritestartpos. 3 (vert. u. 


- 


‘ 


3 


’ 


3 


' 


- 


‘ 


’ 


D>OUPP,UO UP PU U PP I I I I IE I I > I I I > > > > > 


horiz.) 


.- - 


‘ 
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SPR3CTL 15A 
SPR3DATA 15C 
SPR3DATB 15E 
SPRAPOS 160 
SPRACTL 1862 
SPRA4DATA 164 
SPRADATB 166 
SPR5SPOS 168 
SPR5SCTL 16A 
SPR5SDATA 16C 
SPR5SDATB 16E 
SPR6POS 170 
SPR&CTL 172 
SPR6DATA 174 
SPR6DATB 176 
SPR7POS 178 
SPR7CTL 17A 
SPR7DATA 17C 
SPR7DATB 17E 
COLOROO 180 


‚p Spritekontrollreg. 3 u. vert. Stop 
Sprite 3 Datenreg. A (zum RGB-Ausgang) 
Sprite 3 Datenreg. B (zum RGB-Ausgang) 

‚d Spritestartpos. 4 (vert. u. horiz.) 

‚p Spritekontrollreg. 4 u. vert. Stop 
Sprite 4 Datenreg. A (zum RGB-Ausgang) 
Sprite 4 Datenreg. B (zum RGB-Ausgang) 

‚dA Spritestartpos. 5 (vert. u. horiz.) 

‚p Spritekontrollreg. 5 u. vert. Stop 
Sprite 5 Datenreg. A (zum RGB-Ausgang) 
Sprite 5 Datenreg. B (zum RGB-Ausgang) 

‚d Spritestartpos. 6 (vert. u. horiz.) 

‚p Spritekontrollreg. 6 u. vert. Stop 
Sprite 6 Datenreg. A (zum RGB-Ausgang) 
Sprite 6 Datenreg. B (zum RGB-Ausgang) 

‚d Spritestartpos. 7 (vert. u. horiz.) 

‚p Spritekontrollreg. 7 u. vert. Stop 
Sprite 7 Datenreg. A (zum RGB-Ausgang) 
Sprite 7 Datenreg. B (zum RGB-Ausgang) 
Farbregister 0 (Hinergrund u. Rahmnen) 


- 
- 


- 


’ 


“ 
- 


- - - - 
- - - - 


- 
- 


BI ABS ABU DO BU U BB LU UR 


- 


"0000000000000 9000000000000 00 IO PJPU UP O >> I OP > DD» 
OUTOODU OO UTUUTOTUUVOUOTUOUUI UDVUDBDTUTUUUTTUTTUTTUTRAODUALROU U AARAU NARDONMAD 


“ - - - 
- - - - - 


- 


COLOROl1 182 ; Farbregister 1 
COLORO2 184 : Farbregister 2 
COLORO3 186 r Farbregister 3 
COLORO4 188 Farbregister 4 
COLORO5 18A j Farbregister 5 
COLOR0O6 18C 5 Farbregister 6 
COLOR07 18E e Farbregister 7 
COLORO8 190 > Farbregister 8 


COLORO9 192 
COLOR10 194 
COLOR11 196 
COLOR12 198 
COLOR13 19A 
COLOR14 19C 
COLOR15 19E 
COLOR16 1AO 
COLOR17 1A2 
COLOR18 1A4 
COLOR19 1A6 
COLOR20 1AB 
COLOR21 I1AA 
COLOR22 1AC 
COLOR23 I1AE 
COLOR24 1BO0 
COLOR25 1B2 
COLOR26 1B4 
COLOR27 1B6 
COLOR28 1B8 


Farbregister 9 

Farbregister 10 
Farbregister 11 
Farbregister 12 
Farbregister 13 
Farbregister 14 
Farbregister 15 
Farbregister 16 
Farbregister 17 
Farbregister 18 
Farbregister 19 
Farbregister 20 
Farbregister 21 
Farbregister 22 
Farbregister 23 
Farbregister 24 
Farbregister 25 
Farbregister 26 
Farbregister 27 
Farbregister 28 


- - - - - - - - - - - - - - - - - - - 


ERBE ELEKTR STEEL ELISE TEE TEL TE LK L LE LEE IS SEE ES SZCK ES EZ EN 


- 
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COLOR29 1BA w D,p Farbregister 29 
COLOR30 1BC w DB Farbregister 30 
COLOR31 1BE w D,p Farbregister 31 


‘ 


Alle nachfolgenden Register sind’ nur im ECS vorhanden: 


HTOTAL 1C0 
HSSTOP 1C2 
HBSTRT 1C4 
HBSTOP 1C6 
VTOTAL 1C8 
VSSTOP 1CA 
VBSTRT Ice 
VBSTOP ICE 
SPRHSTRT 1DO 
SPRHSTOP 1D2 
BPLHSTRT 1D4 
BPLHSTOP 1D6 
HHPOSW 1D8 
HHPOSR 1DA 
BEAMCONO 1DC 
HSSTRT 1DE 
VSSTRT 1EO 
HCENTER 1E2 
DIWHIGH 1E4 
BPLHMOD 1E6 
SPRHPTH 1E8 
SPRHPTL 1EA 
BPLHPTH 1EC 
BPLHPTL 1EE 


maximale Bildbreite, wenn VARBEAMEN = 1 
horizontale Endpos. des HSync-Signals 
horizontale Startpos. des HBlanks 
horizontale Endpos. des HBlanks 
maximale Bildhöhe, wenn VARBEAMEN = 1 
vertikale Endpos. des VSync-Signals 
vertikale Startpos. des VBlanks 
vertikale Endpos. des VBlanks 
UHRES-Spritestartzeile 
UHRES-Spriteendzeile 
UHRES-Bitplanestartzeile 
UHRES-Bitplaneendzeile 

Dual-Mode: horiz. Elektronenstrahlpos. 
wie HHPOSW, nur lesen 
Elektronenstrahlreg. UHRES, SHRES, PAL 
horiz. Startpos. des HSYNC, wenn VARHSY 
vert. Startpos. des VSYNC, wenn VARVSY 
horiz. Pos. für VSYNC bei Interlace 
obere Bits f. Display-Window-Start/Stop 
UHRES-Bitplane Modulo 
UHRES-DMA-Spriteadresse (Bits 16-20) 
UHRES-DMA-Spriteadresse (Bits 0-15) 
UHRES-DMA-Bitplaneadresse (Bits 16-20) 
UHRES-DMA-Bitplaneadresse (Bits 0-15) 


- - nn - . - - - . 


- 


. 


- . u - - 3 - - - - 
- 


- 


EEE EL EK SEEN ZSE SE SZEE TE ESS 
DD 0 DE a De DC 1 CO Du a DD 0 DD ER 
kb iübkabssimbkdmubmmi mi mi 


- 


Die Register IFO bis IFC sind‘ für spätere Erweiterungen reserviert. 
Das Register IFE hat keine Funktion. 
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1.2 Register 


Zusätzlich zum normalen RAM-Speicher haben die MC680x0- 
Prozessoren noch einige interne Speicher; die Register, mit denen 
man in Maschinensprache programmiert. Welchen Registersatz jede 
CPU besitzt, wurde im Abschnitt 1.1.1 beschrieben. Das Anwender- 
Modell, seit dem MC68000 ist voll aufwärtskompatibel. Die anderen 
CPUs haben noch einige Register dazubekommen. Den Registersatz 
kann man einteilen in Daten-, Adreß-, Status- und System-Register. 
Bis auf wenige Ausnahmen sind alle Register 32-Bit breit. 


A) Datenregister (DO bis D7) 


Es gibt 8 Datenregister, die mit DO bis D7 bezeichnet werden. Jedes 
Datenregister kann bis zu 4 Bytes (32 Bits) aufnehmen, je nach 
Adressierungsart. Alle nicht beeinflußten Bits bleiben unverändert. 
Man benutzt sie, um schneller beliebige Daten verarbeiten zu 
können. Denn die Daten, die sich bereits in der CPU befinden, 
brauchen nicht wieder hineingeschrieben werden. 


B) Adreßregister (AO bis A7) 


Die Anzahl und Funktion ist im Prinzip die gleiche, wie bei den 
Datenregistern, nur werden in der Regel statt "normale" Daten, 
Adressen verarbeitet. Die Adreßregister tragen die Bezeichnungen AO 
bis A7. Eine besondere Rolle spielt das achte Adreßregister (A7). Es 
wird vom Prozessor als Stapelzeiger benutzt, und ist somit für die 
normale Benutzung nicht besonders geeignet. Die Adreßregister 
unterstützen die Adreßformate Long (32-Bit) und Word (16-Bit). Die 
CPU erweitert automatisch die Word-Variante auf volle 32-Bit 
(Vorzeichenrichtig). 
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C) Fließkommadatenregister (FPO bis FP7): 


Diese 8 Register sind 80-Bit breit und sind nur bei einer internen 
bzw. externen FPU vorhanden. Die Funktion entspricht den der 
Datenregister, aber nur für Fließpunkt-Operationen. 


D) Register FPCR, FPSR und FPIAR 


Auf diese Register gehen wir ausführlich im Abschnitt 1.12 ein. Auch 
diese sind nur im Zusammenhang mit einer FPU vorhanden. 


E) Programmzähler (PC) 


Der Programmzähler zeigt immer auf das nächste Word, das die CPU 
lesen soll. Nachdem es gelesen wurde, wird es um ein Word erhöht 
bzw. mit einer neuen Adresse geladen (bei Sprungbefehlen). Auch 
der "PC" ist 32-Bit breit. Es dürfen aber immer nur gerade Adressen 
in den PC übertragen werden, weil das unterste Bit der Adreßleitung 
(Bit O) nicht auf den BUS ausgegeben wird. Wird zum Beipiel 
versucht ein Word über eine ungerade Adresse zu laden (z.B. move.w 
$1001,d0), so kommt es zum Guru mit der Nummer 00000003. 
XXXXXXXX. Dieses ist auch wiederum Abhängig vom Prozessor (siehe 
Abschnitt 1.1.1) 


F) Status-Register (SR) 


Das Status-Register enthält einige wichtige Informationen über den 
Status des Prozessors. Es ist als einziges Register 16 Bits breit und 
aufgeteilt in zwei Bytes. Einmal in das User-Byte (Bits O bis 7) und 
zum Anderen in das System-Byte (Bits 8 bis 15). Das User-Byte hat 
den Namen CCR. Im User-Byte (CCR) sind den ersten fünf Bits Flags 
zugeordnet, die nach einer Operation entsprechend gesetzt werden. 
Das System-Byte gibt Auskunft, in welcher Interruptebene und in 
welchem Proessor-Modus sich die CPU befindet. Auf das Status-Byte 
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kann nur im SuperVisor-Modus zugegriffen werden (Vorsicht). Die 
Bitbelegung des Status-Registers ist folgende: 


Belegung des Status-Registers: 


Bit Name Funktion 


0 C (Carry) Übertragsbit. Bei Überschreitung der Adressierngsgröße durch 
eine Operation. ö 

1 V (Overflow) Überlaufsbit. Gesetzt bei Überlauf von einer Adressierungs- 
grenze zu nächsten. 

2 2 (Zero) Gesetzt, wenn Ergebnis einer Operation = 0 ist 

3 N (Negativ) Gesetzt, wenn Ergebins einer Operation negativ 

4 X (Extended) Wird bei arithmetischen Operationen gesetzt 

5 mem unbenutzt 

6 mn unbenutzt 

7 mmanmmnnanne unbenutzt 

8 10 Hier wird die Interruptebene 

9 1 angegeben (0 bis 7), in der sich 

10 12 die CPU befindet (7 = höchste) 

11 mn unbenutzt 

12 M MasterStack benutzen (nur MC68020/30/40) 

13 $ (Supervisor) Prozessormodus (0 = User, 1 = Supervisor) 

14 TO (Trace) verschiedene Trace 

15 TI (Trace) Modi für Prozessor (Einzelschrittmodus) 


Mit der Einführung des MC68020 wurde das Status-Byte um die Bits 
12 und 14 erweitert (M u. TO). Für den MC68000 gibt es nur ein 
Trace-Bit (T1). Ist dieses gesetzt, befindet sich die 68000-CPU im 
Einzelschrittmodus. Für die anderen Prozessoren ergeben sich 
folgende Funktionen: 


Funktion der Trace-Bits (TO und T1}: 


T1 TO Funktion 

00 Keine Trace-Funktion (Normalzustand) 

0 1 Trace-Exception bei einer Programmflußänderung 
10 Trace-Exception nach jedem Befehl 

11 reserviert 


Die Trace-Bits werden für Diagnostic- und Debugzwecke verwendet. 
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Neben dem System-Byte gibt es noch weitere System-Register, auf 
die nur im SuperVisor-Modus zugegriffen werden kann. 


G) System-StackPointer (USP, ISP, MSP) 


Das Adreßregister A7 wird als System-Stackpointer verwendet. Beim 
MC68000 entscheidet nur das S-Bit, ob A7 als USER-Stackpointer 
(USP, S=0) oder als SuperVisor-Stackpointer (SSP, 5S=1) eingesetzt 
wird. Seit dem M(C68020 entscheidet auch das M-Bit, welcher 
Stackpointer aktiv ist (siehe Tabelle). Den Master-Stackpointer (MSP) 
gibt es bei dem MC68060 nicht. 


Stackbereiche für A7: 


SM Funktion 

0X USP (User-Stack-Pointer) 

10 ISP (Interrupt-Stack-Pointer) oder SSP bei MC68000 
0 MSP (Master-Stack-Pointer) => nicht bei MC68060 


Der MSP oder ISP wird immer bei einer Exception angesprochen. Der 
zweite Stackpointer im SuperVisor-Modus (MSP) dient zum schnellen 
Umschalten zwischen Tasks im Multitasking-Betrieb. Im Amiga wird 
dieser aber nicht eingesetzt. 


H) Das Vektor-Base-Register (VBR) 


Über das Vektor-Base-Register kann man die 1-KByte-Exception- 
Tabelle, die normalerweise ab Adresse Null beginnt, beliebig im 32- 
Bit-Adreßraum verschieben. Dieses funktioniert erst ab dem 
MC68010. Nach einem Reset wird das VBR immer auf Null zurückge- 
setzt. Mit dem privilegierten Befehl "Movec" kann auf das Register 
nur im SuperVisor-Modus zugegriffen werden. Deswegen sollte man 
darauf achten, daß der Wert unter der Adresse 4 nicht überschrieben 
wird, weil sonst auf keine Library mehr zugegriffen werden kann. 
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I) Function-Code-Register (SFC, DFO) 


Mit Hilfe des FCR wird es ermöglicht auf bestimmte reservierte 
Adreßbereiche zurückzugreifen. Auf die Funktion sind wir bereits kurz 
im Abschnitt 1.1.1 eingegangen. Für den Amiga sind diese Register 
nicht von Bedeutung. 


Das waren die wichtigsten Register im Überblick. Die restlichen 
werden etwas ausführlicher in den nächsten Abschnitten beschrieben. 


1.5 Prozessorzustände 


Wie wir bereits im vorangegangenem Abschnitt besprochen haben, 
kann im System-Byte des Statusregisters der Prozessor-Modus einge- 
stellt werden. Es gibt drei Zustände in dem der Prozessor betrieben 
werden kann, auf die wir in den folgenden Abschnitten eingehen. 


1.6 User- oder Supervisor-Modus 


Unser Programm wird normalerweise im User-Modus (Benutzerbe- 
trieb) abgearbeitet, das Betriebssystem hingegen läuf im Supervisor- 
Modus (Überwacherbetrieb). Das hat den Vorteil daß das System alles 
kontrollieren kann. Denn im User-Modus sind einige wichtige 
Maschinenbefehle privilegiert und somit nicht ohne Folgen einsetz- 
bar. Außerdem wird im Supervisor-Modus ein anderer Stackbereich 
benutzt (s. oben). Der "normale" Stackpointer wird mit USP bezeich- 
net. Zudem können auch Speicherzugriffe modusabhängig sein. 
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Der Modus wird durch das Bit 13 im Statusregister bestimmt. Ist das 
Bit gelöscht, so befindet sich der Prozessor im User-, andernfalls im 
Supervisor-Modus. Da sich das Bit im System-Byte des Statusregisters 
befinden und sich dieses nur im SuperVisor-Modus beschreiben läßt, 
ist es "normalerweise" garnicht möglich vom User- in den Super- 
Visor-Modus zu schalten. Wird dieses denoch versucht, zum Beispiel 
mit dem privilegierten Befehl "move.w xx,SR", so wird das laufende 
Programm unterbrochen und eine soganannte Exception (Ausnahme- 
zustand) ausgelöst. | 


Aber keine Angst, denn durch die eben beschriebene Exception ist es 
möglich vom User- in den SuperVisor-Modus zu schalten. Doch dazu 
mehr im nächsten Abschnitt. 


1.7 Exceptions 


Wie schon bereits erwähnt tritt eine Exception auf, wenn ein 
privilegierter Befehl im User-Modus benutzt wird. Eventuell treten 
auch aus anderen Gründen Exceptions (Ausnahmen) ein, zum Beispiel 
bei einer Division durch Null oder ein externes Signal (Reset) usw. 
jedesmal wenn eine solche Ausnahme eintritt, wird in die dazu- 
gehörige Routine verzweigt. Die Adressen dieser Routinen stehen in 
bestimmten Vektoren am Anfang des Speichers. 


Hier eine Übersicht der Vektoren: 


um A Funkti 

$00 $000 Anfangsadresse des SSP bei Reset 

$01  $004 Anfangsadresse des PC bei Reset (Exec-Einsprung) 
$02 $008 Busfehler 

503 $00C Adreßfehler (ungerade Adresse) 

$04 $010 unbekannter Befehl 

$05  $014 Division durch Null 
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$06 $018 Maschinenbefehl CHK/CHK2 

$07 s0IC Maschinenbefehl TRAPV, cpTRAPcc, TRAPcc 
$08 $020 priviligierter Maschinenbefehl 

$09 $024 Trace-Modus (Bit 15 = 1 im Status-Register) 
$0A 028 Befehlscode-Emulation ($Axxx) 

$0B $02C Befehlscode-Emulation ($Fxxx) 

$0C $030 Hardware-Breakpoint (nur CPU32: 68332) 
$0D 034 Coprozessor-Protokoll-Verletzung (MC68000/20/30) 
$0E 038 Format-Fehler (Stack wurde geändert) 

$0OF  $O3C nicht initialisierter Interrupt 

$10-$17 $040-$5C reserviert 

$18 $060 unberechtigter Interrupt 

$19  $064 Interruptebene Level 1 

$1IA 068 Interruptebene Level 2 

$1B $06C Interruptebene Level 3 

$1C $070 Interruptebene Level 4 

$1D 074 Interruptebene Level 5 

$IE $078 Interruptebene Level 6 

$IF $07C Interruptebene Level 7 


$20-$2F $080-$0BC Vektoren der TRAP-Maschinenbefehle 
;---- Nur wenn eine FPU vorhanden ---- 


$30 $0CO FBcc, FDBec, FTRAPcc, FScc 

$31 $0C4 ungenaues Ergebnis 

$32 $0C8 Fließpunktdivision durch Null 

933  $OCcC Fließpunktunterlauf 

$34 $0DO Fließpunkt-Operand-Fehler 

$35  $0D4 Fließpunktüberlauf 

$36 $0D8 kein genormter Wert 

$37  $0DC nicht impl. Fließpunktdatentyp (MC68040/60) 
;--- nur wenn eine PMMU vorhanden ---- 

$38 $OEO PMMU-Konfigurationsfehler (MC68020/30) 

$39  $OE4 unerlaubter PMMU-Betrieb (MC68020) 

$3A $0E8 unerlaubter PMMU-Zugriff (MC68020) 

$3B HOEC reserviert 

$3C  $OFO nicht implementierte effektive Adresse (MC68060) 
$3D $OF4 nicht implementierter Integer-Befehl (MC68060) 


$3E- $3F $OF8-$OFC reserviert 
$40-$FF $100-$3FF Anwender-Inerruptvektoren 
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Achtung! - Ab dem MC68010 existiert ein VectorBase-Register über 
das die Vektorentabelle an jede Adresse des Speichers gelegt werden 
kann. Dieses Register wird aber von so gut wie keinem Programm 
genutzt, weil sonst die Softwarekompatibilität nicht mehr gewähr- 
leistet wäre. Wenn Sie Ihr Programm aber 100 Prozent Kompatibel 
halten wollen, so folgt hier ein kleines Listing, das die 
Anfangsadresse der Vektoren berechnet. Die Routine funktioniert aber 
nur im SuperVisor-Modus. Also müssen Sie vorher in den SuperVisor- 
Modus schalten, z.B. mit der Exec-Funktion "SuperState ()". Sie 
benötigt keine Parameter und gibt uns in DO die Adresse des alten 
Stackpointers zurück (vor dem Aufruf). Diese benötigen wir für die 
Exec-Funktion "UserState ()". Ihr müssen wir die Adresse in DO 
übergeben. Anschließend schaltet sie wieder zurück in den User- 
Betrieb. 


;---- Berechnung der Vektorenadresse ----- 


‘ 


move.|l 4,36 

movegq #0,d0 ‚ Standartvektoradresse = 0 
move.l dO,VektorBase ; und speichern 

move.w 296(a6),d1 ‚ AttnFlags holen 

btst #1,d1 ‚ 68010 Prozessor vorhanden ? 
beq Nein 

move.l 4,36 

jsr -150(a6) ; SuperState () 

move.|l dO,OIdSP ‚ alten Stack retten 
movec vbr,dO ; Vektoradresse holen 
move.|l dO,VektorBase ; und speichern 

move.|l 4,36 

move.|l OldSP,dO 

jsr -156(a6) ; UserState () 


Nein: 


; hier folgt eigenes Programm 


VektorBase: dc.|IO 
OldSP: dc.I Oo 
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Über die AttnFlags kann festgestellt, welcher Prozessor eingebaut 
wurde: 


Auflistung der AttnFlags (Offset 296 - Execbase): 


Bit_ Prozessor 

O 68010 

1 68020 

2 68030 

3 68040 inkl. MMU 
4 68881 MMU 

5 68882 MMU 

6 68851 MMU 

7 68060 inkl. MMU 


Erklärung der einzelnen Begriffe: 


Reset: Anlangsadresse SSP und PC 


Bei einem Reset werden die hierstehenden Adressen als Stackpointer 
für den Supervisor-Modus und als Programmzähler übernommen. Mit 
Hilfe des OVL-Bit (Overlay) der CIA, wird das Kickstart nach Adresse 
Null gespiegelt und holt sich somit die korrekten Adressen des SSP 
und PC zum "Booten" des Amiga-Betriebsystems. 


Busfehler 


Er wird durch die Hardware ausgelöst, wenn z.B. auf einen nicht vor- 
handenen Speicherbereich zugegriffen wird. 
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Adresstehler 

Diese Exception wird ausgelöst, wenn mit einem \Word- bzw. 
Langword-Zugriff auf eine ungerade Adresse zugegriffen wird. 
unbekannter Befehl 

Da bei den MC680x0-Prozessoren 65536 Befehle möglich sind, diese 
aber nicht so viele kennen, wird bei einem unbekannten Befehl in die 
hier stehende Adresse gesprungen. 

Division durch Null 

Wird mit einem Divisions-Maschinenbefehl durch Null geteilt, was 
mathematisch nicht erlaubt ist, tritt diese Exception auf, 
CHK-Maschinenbefehl 


Diese Exception tritt auf, wenn beim Test eines Datenregisters mit 
dem CHK-Befehl die Grenzen überschritten werden. 


JRAPV-Maschinenbefehl 


Wird der Maschinenbefehl TRAPV ausgeführt und ist gleichzeitig das 
V-Bit im Status-Register gesetzt, so tritt diese Ausnahme ein. 


privilegierter Befehl 
Wird im User-Modus ein privilegierter Befehl benutzt, so wird diese 


Exception ausgelöst. Hierüber kann in den Supervisor-Modus ge- 
schaltet werden. 
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Trace-Modus 


Ist das Bit 15/14 im Status-Register gesetzt, so wird nach jedem 
Maschinenbefehl bzw. nach jeder Verzweigung in diese Adresse 
verzweigt. 


Befehlscode-Emulation ($Aoıx, $Prox) 


Wird ein Maschinenbefehl aufgerufen, der mit der Bitkombination 
%1010 ($A) oder %1111 ($F) beginnt, so wird in die entsprechende 
Adresse verzweigt (für Maschinenbefehlserweiterungen). 


level 1 bis 7 Interrupt 


Hier stehen die Interruptadressen der 7 Interruptebenen. Um welche 
Interrupts es sich handelt wird im nächsten Abschnitt beschrieben. 
Wenn der im Status-Register enthaltene Interrupt-Level höher ist als 
der hier aufgetretene, so wird letzterer ignoriert. 


JRAP-Befehlsvektoren 

Diese 16 Vektoren werden verwendet, wenn der dazugehörige TRAP- 
Maschinenbefehl benutzt wird. Die TRAP-Befehle sind von O bis 15 
durchnummeriert. 

Benutzer-Interrupt-Vektoren 

Einige Peripherie-Bausteine lösen einen Interrupt mit eigener Vektor- 


nummer aus. 


ACHTUNG! - Jede Exception-Routine sollte mit einem "RTE"- 
Maschinenbefehl enden, weil dadurch der alte Zustand wiederherge- 
stellt und das User-Programm fortgesetzt wird. 
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Die Interrupts funktionieren ähnlich wie die Exceptions. Auch sie sind 
Programmunterbrechungen, allerdings ausgelöst von einem Peri- 
pherie-Baustein oder einer externen Schaltung. 


Tritt ein gültiger Interrupt auf, z. B. wenn der 3-Bit-Wert (lO bis 12) 
kleiner ist, als die Priorität des anliegenden Interrupts, so wird zu der 
Adresse gesprungen, welche in der dazu- gehörigen Interruptebene 
steht. 


Fast alle Ein- und Ausgabeeinheiten der Custom-Chips und die beiden 
ClAs sind in der Lage, einen Interrupt auszulösen. Dabei übernimmt 
eine Schaltung innerhalb des Custom-Chips "Paula" die Verwaltung 
der einzelnen Interrupts und erzeugt die entsprechenden Signale für 
die CPU. 


Ohne diese Programmunterbrechungen wären die Möglichkeiten 
eines Computers sehr eingeschränkt. Wie sollte man sonst zum Bei- 
spiel sein Programm mit der Hardware synchronisieren. Das Betriebs- 
system zum Beispiel, nutzt den Vertikal-Blank Interrupt und die CIA- 
Timer, um das Multitasking verarbeiten zu können. 


Welche Interrupts auftreten dürfen, wird im "INTENA"-Register fest- 
gelegt. Wurde ein Interrupt erzeugt, wird in die dazugehörige Inter- 
ruptebene verzweigt. Hier muß als erstes der aufgetretene Interrupt 
zurückgesetzt werden, wofür das "INTREQ"- Register zuständig ist. 
Außerdem muß das Interrupt- wie das Exceptionprogramm mit einem 
"RTE"- Maschinenbefehl enden. Es wird auch ein Interrupt ausgelöst, 
wenn ein Bit mittels eines Maschinenbefehls im "INTREQ"-Register 
gesetzt wird. Auf diese Weise kann auch der Copper nur seinen 
Interrupt auslösen. 


Der Amiga bietet einem die Wahl zwischen 15 verschiedenen Ereig- 
nissen, bei denen ein IRQ) ausgelöst wird. Es stehen einem jedoch nur 
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7 verschiedene Interruptebenen zur Verfügung. Deswegen bekommt 
jeder der 15 möglichen Interrupts eine CPU-Priorität zwischen 1 und 
7 zugeteilt. Alle Interrupts mit gleicher CPU-Priorität werden zu einer 
Ebene zusammengefaßt. Zusätzlich erhält jeder eine Pseudo-Priorität 
zwischen O0 und 14. Der Interrupt, welcher die höhere Pseudo- 
Nummer trägt, wird dann zuerst abgearbeitet. 


Hier nun die Bitbelegung der beiden Register INTENA und INTREQ. 
Beide Register haben die gleiche Belegung. Die Bitnummer gibt 
gleichzeitig die Pseudo-Priorität an. 


Rgisteradresen: INTENA 
INTREQ 


$DFFO9YA 
$DFFOIC 


Beide Register können auch gelesen werden. Dazu stehen einem 
folgende Register zur Verfügung. 


Registeradressen INTENAR = $DFFOIC 

zum Lesen: INTREQR = $DFFOIE 

Bit_Name Ebene Adresse Ereignis 

15  SET/CLR schreiben/lesen 

14 INTEN Interrupts erlauben (Bits O bis 13) 
13 EXTER 6 9078 CIA-B oder Expansionsport-Interrupt 
12 DSKSYN 5 074 Disk-Synchronisationswert erkannt 
11  RBF 5 5074 Serieller Port voll 

10 AUDIO3 4 $070 Audiokanal 3 gibt Daten aus 

9 AUDIO2 4 $070 Audiokanal 2 gibt Daten aus 

8 AuUDIOI 4 $070 Audiokanal 1 gibt Daten aus 

7 AUDIOO 4 $070 Audiokanal O gibt Daten aus 

6 BLIT 3 H06C Blitteroperation beendet 

-5 VERTB 3 H06C Beginn der vertikalen Austastlücke 
4 COPPER 3 H06C Copper erzeugt einen Interrupt 
-3 PORTS 2 068 CIA-A oder Expansionsport-Interrupt 
2 SOr 1 9064 Software-Interrupt 

1 DSKBLK 1 9064 Disk-DMA beendet 

0 TBE 1 5064 Ausgabepuffer des seriellen Ports leer 
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Möchte man einen Interrupt erlauben, so muß das "SET/CLR"-Bit, das 
"INTEN"-Bit und das gewünschte Interrupt-Bit gesetzt werden. 


Beispiel zum Erlauben des Copperinterrupts: 
Bits 15, 14 und 4 setzen: move.w #$c010,$dff09a 
Um einen Interrupt zu verbieten, muß man das "SET/CLR"-Bit, das 
gewünschte Inerrupt-Bit löschen und alle anderen Bits setzen. 
Beispiel zum Verbieten aller Interrupts: 
Bit 15 löschen: move.w #$7fff,$dff09a 
Ist ein Interrupt aufgetreten, so muß dieser, wie bereits erwähnt, vom 
Inerruptprogramm als erstes zurückgesetzt werden. Dazu muß man 
das entsprechende Bit im "INTREQ"-Register setzen. 
Beispiel zum Zurücksetzen des Copperinerrupts: 


Bit 4 setzen: move.w #$0020,$dff0% 
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1.7 DMA-Kanäle 


Unter "DMA" versteht man den direkten Zugriff eines Custom-Chips 
auf den CHIP-Speicher (DMA => Direct Memory Acces). Der DMA- 
Controller befindet sich im Agnus/Alice-Chip und überträgt selbstän- 
dig Daten von unterschiedlichen Ein- und Ausgabeeinheiten vom 
oder zum CHIP-RAM. Das hat den Vorteil, daß der Prozessor nicht 
benutzt werden muß. Zudem erledigt der DMA-Controller den 
Datentransfer erheblich schneller. 


Es sind folgende DMA-Kanäle vorhanden: 


DMA-Kanal_ Funktion 

Bitplane Ließt Bildschirmpixel aus dem CHIP-Speicher und schreibt 
diese in die Bitebenen. 

Copper Hierüber gelangen die Befehlsworte zum Co-Prozessor 


Blitter Datentransfer zum und vom Blitter 

Sprite Spritedatentransfer vom Chip-Speicher in die Sprite- 
Datenregister 

Disk Datentransfer zur und von Diskette 


Audio Überträgt die digitalen Tondaten aus dem CHIP-RAM 
in die entsprechenden Audiodatenregister 


Die einzelnen DMA-Kanäle können über das Kontrollregister 
"DMACON" ein- und ausgeschaltet werden. 


Registeradressen: schreiben => DMACON = $DFFO96 
lesen => DMACONR = $DFFOO2 
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Bit Name _ Funktion 
15 SET/CLR Bits löschen oder setzen 


14 BBUSY Blitter-DMA gerade in Funktion (nur lesen) 

13 BZERO Ergebnis der Blitteroperationen war 0 (nur lesen) 
12 ------ unbenutzt 

11 ------ unbenutzt 


10 BLTPRI Blitter-DMA hat Priorität über Prozessor 
DMAEN Gesamt-DMA einschalten (Bits O0 bis 8) 
BPLEN Bitplane-DMA zulassen 

COPEN Copper-DMA zulassen 

BLTEN Blitter-DMA zulassen 

SPREN Sprite-DMA zulassen 

DSKEN Disk-DMA zulassen 

AUD3EN Audio-DMA für Tonkanal 3 zulassen 
AUD2EN Audio-DMA für Tonkanal 2 zulassen 
AUDI1EN Audio-DMA für Tonkanal 1 zulassen 
AUDOEN Audio-DMA für Tonkanal 0 zulassen 


Or» Uun „Jo % 


Das DMACON-Register wird im Prinzip wie das INTENA-Register 
beschrieben. Es können nur Bits gesetzt oder gelöscht werden. Ist das 
SET/CLR-Bit(15) auf 1, so werden alle gesetzten Bits im DMACON- 
Register gesetzt. Ist es hingegen 0, so werden alle gesetzten Bits 
gelöscht. Alle übrigen Bits bleiben immer unbeeinflußt. 

Das mit DMAEN bezeichnete Bit 9 dient als Hauptschalter für alle 
DMA-Kanäle. Ist es auf O, sind die Bits O bis 8 ohne Funktion. Ist es 
auf 1, so sind alle DMA-Kanäle, deren Bits gesetzt sind aktiv. 

Beispiel zum Verbieten des Sprite-DMASs: 


nur Bit 7 setzen => move.w #%0020,$dff096 


Beispiel zum Erlauben des Sprite-DMASs: 


Bit 15, 9 und 5 setzen => move.w #%8220,$dff096 
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1.10 Die Befehle der CPUs 


Die MC680x0-Prozessoren bieten eine Vielzahl von Adressierungs- 
arten. Mit der Adressierung legen wir die Operationszugriffsart eines 
Befehls fest. Schon der MC68000 bietet so viele Möglichkeiten, daß 
das Programmieren zur Freude wird. Seit dem MC68020 sind noch 
einige hinzugekommen. Heutzutage geht man aber immer mehr zum 
reduzierten Befehlssatz über. Die sogenannten RISC-Prozessoren 
verfügen nur über einen minimalen Befehlssatz und sind dadurch 
(nicht nur dadurch) um ein vielfaches schneller als die herkömmlichen 
CISC-Prozessoren. Spezielle Befehle müssen dann mit den Grundbe- 
fehlen "zusammengebastelt" werden. Die Ausführungszeit ist aber 
immer noch wesentlich höher als bei CISC-Prozessoren. Doch zurück 
zu den MC680x0-CPUs (CISC-Prozessoren). 


Wir unterscheiden einfache und komplexe Adressierungsarten. Die 
komplexen sind erst ab dem M(C68020 vorhanden. Welche 
Adressierungsarten es bei welchen Prozessoren gibt, zeigt die 
folgende Tabelle. Danach folgt jeweils ein Beispiel zu jeder Adres- 
sierungsart. Eine ausführliche Beschreibung finden Sie in entsprechen- 
der Fachliteratur (Assembler-Buch etc.). 


Tablle der Adressierungsarten 


A = einfache Adressierungsart 
B = komplexe Adressierungsart 
1 = MC68000 

2 = M(C68020 

3 = MC68030 

4 = MC68040/60 
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Opcode 

Art_Adressierung Mnemonik Modus Register 1 2 3 4 
A Datenregister direkt Dn 000 Reg.Nr. XXXX 
A Adreßregister direkt An 001 Reg.Nr. XXXX 
A Adreßreg. indirekt (ARI) (An) 010  Reg.Nr. XXXX 
A ARI mit Postinkrement (An)+ 011 Reg.Nr. XXXX 
A ARI mit Predekrement -(An) 100 Reg.Nr. XXXX 
A ARI mit 16-Bit-Adreßdistanz d16(An) 101 Reg.Nr. XXXX 
A ARI mit Index -+ mit/ohne 8-Bit-Adreß- 

distanz d8(An.Ri.s) 110 Reg.Nr. XXXX 
A PC-relativ Label[pc) 111 010 XXX 
A absolut kurz BXXXX 111 000 XXX 
A absolut lang HBAXXXXXXX 111 001 XXX 
A Konstante,Statusreg. #,SR,CCR 111 100 XXX 
A ARI mit Index+ mit/ohne 32-Bit- 

Adreßdistanz und Scalierung (d32,An,Ri.s*scl) 110 Reg.Nr.. XXX 
A PC-relativ mit Index + mit/ohne 

32-Bit-Adreßdistanz u. Scalierung (Label,PC,Ri.s*scl) 111 011 XXX 
B doppelt indirekt, Post-Index ([d32,An],Ri.s*scl,d32) 110 Reg.Nr. XXX 
B doppelt indirekt, Pre-Index (fd32,An,Ri.s*scl,d32) 110  Reg.Nr. XXX 
B doppelt indirekt, PC-relativ, 

Post-Index ((d32,PCJRi.s*scl,d32) 111 011 XXX 
B doppelt indirekt, PC-relativ, 

Pre-Index ((d32,PC,Ri.s*sclld32) 111 011 XXX 


Beispiele zu den Adressierungsarten 


1) Datenregister direkt 
- move.w DO,D1I (Inhalt von DO nach D1) 


- clr.w DO (Inhalt von DO löschen) 


2) Adreßregister direkt 
- move.w D1,AO (Inhalt DI nach AO u. Erweiterung auf 32-Bit) 
- move.| A1,A2 (Adresse in Al nach A2) 


3) Adreßregister indirekt (AR|) 
- move.w DO,(A1) 


(Word-Inhalt von DO unter der Adresse von A1 speichern) 
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4) Adreßregister indirekt mit Postinkrement 
- move.| D7,(AO) + 


(Long-Inhalt von D7 unter der Adresse von AO speichern und danach 
die Adresse in AD um ein Longword (vier Bytes) erhöhen) 


5) Adreßregister indirekt mit Predekrement 
- move.w D5,-(A5) 


(Adresse in A5 um 1 Word (2 Bytes) erniedrigen und danach den 
Word-Inhalt von D5 unter der neuen Adresse speichern) 


6) Adreßregister indirekt mit 16-Bit-Adreßdistanz 
- move.w D4,$10A(AO) 


(Word-Inhalt von D4 unter der Adresse speichern, die sich aus der 
Summe der Adresse von AO und dem Offset $10A ergibt) 


7) Adreßregister indirekt mit Index+ mit/ohne 8-Bit-Adreßdistanz 
- move.| D3,$FF(A1,D5.w) 


(Long-Inhalt von D3 unter der Adresse speichern, die sich aus der 
Summe der Adresse von Al, dem Offset $FF und dem Word-Inhalt 
von D5 ergibt) 


8) PC-relativ 


- move.w Hallo(Pc),D1 Ä 
(Word-Wert aus der Adresse auf die Hallo zeigt nach DI schreiben. 
Hallo darf keinen größeren Offset als $FFFF haben) 


9) PC-relativ mit Index 
- move.w Hallo(PC,D2.w),D1 


(Wie oben, nur daß sich die Adresse jetzt aus der Summe von Hallo 
und Word-Inhalt von D2 ergibt) 


10) absolut kurz 
- move.| DO,$10AO 


(Long-Inhalt von DO unter der Adresse von $000010A0 speichern) 
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11) absolut lang 
- neg.w $AAO0O 


(Word-Inhalt unter der Adresse $000AAO000 negieren) 


12) Konstante, Statusregister 

- moveq #0,DO (DO mit dem Wert O laden; 32-Bit) 
- move.w D1,SR (SR mit Wert aus D1 laden) 

- move.w CCR,DO (Inhalt des CCR nach DO) 


13) ARI mit Index+mit/ohne 32-Bit-Adreßdistanz und Scalierung 

- move,w $FA(AO,D1.1*4),D6 

- move.w $FFFFO200(A0),D5 

(Wie Nr. 7, nur das noch Datenreg.1 mit 4 multipliziert wird. Der 
Faktor für die Scalierung kann 0,1,2,4, oder 8 sein) 


Alle restlichen Adressierungen funktionieren nach dem gleichen 
Prinzip wie unter Punkt 13 beschrieben. 


Die neueren Prozessoren (ab MC68020) haben unter anderem 


zusätzlich spezielle BIT-Funktionen und 64-Bit-Multiplikationsbefehle. 
Beschreibungen dazu, finden Sie in entsprechender Literatur. 
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1.11 Die Cache-Programmierung 


Unter Cache versteht man das Zwischenspeichern von Daten in einem 
sehr schnellen internen Speicher, der bereits im CHIP (CPU) integriert 
ist. Dabei wird immer die Adresse, die Daten und ein Gültigkeitsbit 
gespeichert. Wird dann ein zweitesmal auf diesen Speicher zugegrif- 
fen, vergleicht eine Logik in der CPU, ob sich die Daten bereits im 
internen Cache befinden. Ist dieses der Fall, so werden die Daten 
jetzt erheblich schneller aus dem internen Cache geholt. Dieses 
Prinzip funktioniert hauptsächlich nur bei Schleifen, die die Cache- 
größe nicht übersteigen. 


Der MC68020 besitzt einen internen 256-Byte-Cache, der Platz für 
64-Einträge zu je 32-Bit hat. Gesteuert wird dieses Cache über die 
Register CAAR (Cache-Adreß-Register) und CACR (Cache-Control- 
Register). 


Aufbau des Cache-Control-Register (CACR) für den MC68020: 


Bit Name Funktion 

0 E Enable - Cache ein- bzw. ausschalten (O=aus) 

IF Freeze - Cache einfrieren. Es werden keine neuen Daten 
in den Cache übernommen. Es wird mit den aktuellen 
Werten weitergearbeitet (Z.B. für Unterprogrammaufrufe) 

2 CE Clear Entry - Einen Eintrag löschen. Die Adresse für 
diesen Eintrag muß im CAAR stehen 

3 £ Clear - gesamten Cache löschen (C=O) 

4-31 - unbelegt 


Die beiden Register gehören auch zu den System-Registern und 
können nur im SuperVisor-Modus mit dem Befehl "Movec" bearbeitet 
werden. 
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Der MC68030 hat einen 512-Byte Cache. Dieser wurde aufgeteilt in 
einen 256-Byte Daten- und einen256-Byte Befehlscache. Organisiert 
sind diese Caches in 16 Einträgen zu je 128 Bits (4 Longwords). Auch 
hier wird das Cache durch die Register CAAR und CACR gesteuert. 


Aufbau des Cache-Control-Register (CACR) für den MC68030: 


| = Instruktion (Befehl) D = Data (Daten) 


Bit Name _ Funktion 

:D EB Enable - Befehls-Cache ein- bzw. ausschalten (O=aus) 

' PR Freeze - Befehls-Cache einfrieren. Es werden keine neuen 
Daten in den Cache übernommen. Es wird mit den 
aktuellen Werten weitergearbeitet (Z.B. für Unterpro- 
grammaufrufe) 

2 CEI Clear Entry - Einen Eintrag löschen. Die Adresse für 
diesen Befehls-Eintrag muß im CAAR stehen 

3 Cl Clear - gesamten Befehls-Cache löschen (C=0) 

4 IBE Instruction-Burst-Enable (Burst-Modus für Befehls-Cache) 

5-7 --- unbelegt 

8 ED Funktion, wie 

9 FD BitsObis3, 

10 CED aber für 

11 CD den Daten-Cache 

.12 DBE Data-Burst-Enable (Burst-Modus für Daten-Cache) 

»13 WA  Write-Allocation (WA= 1, dann wird Daten-Cache immer 
auf den neuesten Stand gebracht. Bei Schreibzugriffen 
wird der Wert in den Speicher u. den Cache geschrieben) 

14-31 -- unbelegt 


Der Burst-Modus ist ein spezieller Vorgang, bei dem vier Longwords, 
also der gesamte Eintrag, innerhalb von 5 Taktzyklen (Minimum) 
übertragen werden. Dafür ist aber ein synchroner 32-Bit-Bus und 
schneller Speicher erforderlich. Andernfalls müssen Wartezyklen 
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eingeschoben werden. Ob sich die Aktivierung des Burst-Modus 
lohnt, sollten Sie mit Benchmark-Tests ausprobieren. 


Für den MC68040 wurde der Daten- und Befehlscache auf je 4-KByte 
erhöht. Jeder Eintrag besteht aus 16-Bytes (4 Longwords). Der 
Unterschied zum MC68030 ist, daß es nur noch ein Valid-Bit für alle 
vier Longwords gibt. Also müssen jedesmal die kompletten 16-Bytes 
bei Ungültigkeit in den Cache geladen werden (nur für Befehls- 
Cache). Die Longwords für jeden Eintrag beim Daten-Cache haben 
jeder ein Dirty-Bit. Dieses ist für den Copyback-Modus erforderlich 
und kennzeichnet ein ungültiges Longword, daß nicht mehr mit dem 
ursprünglichen Wert aus dem Speicher übereinstimmt (Selbstmodifi- 
zierender Code). Durch die integrierte MMU stehen für jeden Page- 
Deskriptor zwei Bits für den Cache-Modus bereit (CM = CacheMode). 


Cache-Modi des MC68040 (Page-Deskriptor): 


CM-Bits Funktion 


00 normale Cache-Funktion, wie beim MC68030 

01 Copyback-Modus (siehe oben) 

10 Cache inhibited, serialized (Cache aus) 

11 Cache inhibited, non-serialized (Cache aus, Inhalt aktiv) 


Der MC68040 besitzt eine Snoop-Logik (Schnüffel-Logik), die den 
Speicher-Cache-Zugriff überwacht und ggfs. bei ungültigen Cache, 
z.B. durch selbstmodifizierenden Code, aktualisiert (Copyback-Modus). 
Beim MC68030/20 (ohne Snoop-Logik) führte dieses immer zu 
Fehlern (Programmabsturz). 


Das CACR-Register existiert für den MC68040 nicht mehr. Dafür gibt 
es jetzt neue privilegierte Befehle. 
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neue privilegierte Cache-Befehle für den MC68040/60 


Befehl Adressier Funkti 

CINVL  cache,(An) Cache-Invalidate-Line (Löschen einer Line im Cache) 
CINVP  cache,(An) Cache-Invalidate-Page (Löschen einer Page im Cache) 
CINVA cache Cache-Invalidate-All (Löschen des gesamten Cache) 
CPUSHL cache,(An) Lesen und löschen einer Line im Cache 

CPUSHP cache,(An) Lesen und löschen einer Page im Cache 

CPUSHA cache Lesen und löschen des gesamten Cache 


An = Adreßregister 
cache =IC (Befehlscache) oder DC (Daten-Cache) oder BC (beide Cache-Arten) 


Beispiel: CINVL DC,(A1) 


Der Cache für den MC68060 ist ähnlich wie der vom MC68040 
aufgebaut. Die Größe wurde nochmals auf 8-KByte erweitert. Der 
Daten-Cache hat jetzt nur noch 1-Dirty-Bit pro Eintrag und der Befehl 
CPUSHx speichert nur noch Einträge (16 Bytes), keine einzelnen 
Longwords. Die Snoop-Logik kann nur noch einen Eintrag als 
ungültig erklären und nicht mehr aktualisieren. Das Cache-Control- 
Register (CACR) ist wieder vorhanden und wurde um einige Bits 
erweitert. 


Aufbau che-Control-Register (CACR) für den MC68060: 


Bit Name Funktion 

0-12 --  unbelegt (Null) 

13 PIC 1/2-Cache-Modus für Befehle aktivieren (FlC=1) 

14 NAl Kein Allocate-Mode ermöglichen für Befehls-Cache 

13 BE Enable-Instruction-Cache (1 =Enable) 

16-20 -- unbelegt (Null) 

21 CUBC Clear all User entries in the Branch-Cache (Sprung-Befehle) 
22 CABC Clear all entries in the Branch-Cache (Sprung-Befehle) 

23 EBC _ Enable-Branch-Cache 

24-26 -- unbelegt (Null) 
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21 FOC 1/2-Cache-Modus für Daten-Cache aktivieren 

28 DPI Disable-Push-Invalidation für Daten-Cache 

29 ESB Enable Store Buffer (4 entries FIFO => Firstin FirstOut) 
30 NAD Enable No Allocate-Mode für Daten-Cache 

31 EDC Enable Data-Cache (1 =Enable) 


Das System bietet einem ab Kickstart 2.0 (V37) einige Funktionen für 
die Cache-Programmierung. Auf keinen Fall sollte man die Register 
direkt modifizieren. Es könnte zu Systemabstürzen führen. 


Routine: KCacheClearE (AO,DO,D1) (adress,Length,Caches) 
Offset: -642 
Library: exec.library ab V37 (Kickstart 2.0) 
Parameter: AD = Anfangsadresse, ab der die Daten in 
den Speicher zurückgeschrieben werden sollen. 


DO = Anzahl der Daten oder -1 für alle Daten 
des Caches. 
DI = Flags, welcher Cache als ungültig gekennzeich- 


net werden soll. 

CACRF Clearl (Bit 3) für Befehlscache löschen 

CACRF ClearD (Bit 11) für Datencache löschen 
Rückgabe: keine 
Erklärung: 
Diese Funktion "flush" den Cache. Das heißt, daß der Inhalt des 
Daten- bzw. Befelscache in den Speicher zurückgeschrieben wird und 
danach die Einträge als ungültig makiert werden. Welcher Cache 
betroffen ist und wieviel Einträge hängt von den Parametern ab. Den 
Cache muß man immer "flushen", wenn Daten zum Beispiel durch 
folgende Operationen geändert werden: 


- selbstmodifizierender Code 

- beim Aufbau von Sprungtabelle 

- Relocated Code (Programme die an jede Adresse stehen können) 

- wenn Programme von einem Medium in den Speicher geladen werden 
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Das System "flushed" immer den Cache, wenn es erfoderlich ist. So 
wird der Befehlscache immer gelöscht, sobald über die Routinen 
"LoadSeg()", "MakeLibrary{)" und "SetFunction()" Befehle geändert 
werden. Ä 


Für alle Amiga-Modelle ist, beim Zugriff auf das CHIP-RAM, der 
Befehlscache erlaubt und der Datencache verboten. Die Custom- 
Register ab Adresse $DFFO0O sind hardwaremäßig vor dem Cache- 
Zugriff geschützt. 


Routine: CacheClearU () 

Offset: -636 

Library; exec.library ab V37 (Kickstart 2.0) 

Parameter: keine 

Rückgabe: keine 

Erklärung: 

Diese Funktion "flushed" den Daten- und Befehlscache. Alle Einträge 
werden erst in den Speicher zurückgeschrieben und danach als 
ungültig erklärt. 


Routine: KCacheControl (DO,D1) (cacheBits,cacheMask) 
Offset: -648 


Parameter: DO = hier können die einzelnen Caches ein- bzw. aus- 
geschaltet werden (Cache-Control-Register: CACR). 
Di = Maske die bestimmt, welche Bits geändert 


werden sollen. 
Rückgabe: => DO = oldBits. Alter Wert des Cache-Control- 
Registers. 

Erklärung: 

Mit dieser Funktion kann das Cache-Control-Register beeinflußt 
werden. Welche Bits erlaubt sind (cacheBits), steht im CacheControl- 
Eintrag (Offset 572) der Exec-Library (siehe unten). Das System 
erkennt automatisch, welche CPU im Rechner arbeitet und behandelt 
den übergebenen Wert entsprechend. Bevor der neue Wert gesetzt 
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wird, wird der gesamte Cache (Daten und Befehls) "geflushed". Die 
Routine ist mit Vorsicht zu genießen, weil sie Auswirkungen auf das 
gesamte System hat und nicht für jeden einzelnen Task getrennt 
funktioniert. Für die MC68060-CPU muß diese Funktion gepached 
werden, weil sich die Belegung des CACR geändert hat. 


"ex CacheControl"-Eintrag in der Exec-Library (Offset 572) 


Bit Name Funktion 


O Enablel Befehls-Cache erlauben (l=Instruction) 

1 Freezel Befehls-Cache einfrieren 

3 Clearl Befehls-Cache löschen 

4 IBE Burst-Modus für Befehls-Cache erlauben 

8 EnableD Daten-Cache erlauben (D= Data) (MC68030) 
9 FreezeD Daten-Cache einfrieren (MC68030) 
11 ClearD Daten-Cache löschen (MC68030) 
12 DBE Burst-Modus f. Daten-Cache erlauben (MC68030) 
13 WriteAllocate siehe MC68030. Muß immer gesetzt sein. 

30 EnableE externen Cache erlauben 

31 CopyBack Copyback-Modus erlauben (muß auf 1 sein) 


Routine: CachePostDMA (A0,A1,DO) (Vaddress,length,flags) 
Offset: -768 
Library: exec.library ab V37 (Kickstart 2.0) 


Parameter: AD = Startadresse vom Speicher der "geflushed" 
werden soll. 
Al = Zeiger auf ein Longword, welches die Länge 


(Anzahl Bytes) beinhaltet, die "geflushd" 
werden sollen. 
DO = Flags für die Operation (siehe unten) 
Rückgabe: keine 
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Erklärung: 

Diese Funktion muß aufgerufen werden, wenn über DMA (Direct- 
Memory-Acess) Daten in den Speicher geschrieben wurden (Nach 
dem DMA-Transfer aufrufen). Wichtig, damit der Daten-Cache 
"geflushed" wird (wegen oben erwähnten Gründen). Diese Routine ist 
wichtig für Programmierer von einem Device, das über DMA Daten 
transferiert. Diese Funktion hat erst eine Auswirkung ab dem 
MC68030. 


Routine: CachePreDMA (A0,A1,DO) (Vaddress,length,flags) 
Offset: -762 
Library: exec.library ab V37 (Kickstart 2.0) 


Parameter: AD = Startadresse vom Speicher der "geflushed" 
werden soll. 
Al = Zeiger auf ein Longword, welches die Länge 


(Anzahl Bytes) beinhaltet, die "geflushd" 
werden sollen. 
DO = Flags für die Operation (siehe unten) 

Rückgabe: => DO = paddress (physikalische Adresse, die der 

internen virtuellen Adresse enspricht (Vaddress) 
Erklärung: 
Diese Funktion muß vor einem DMA-Zugriff aufgerufen werden, 
damit der Cache "geflushed" wird. 


Wenn man also Daten über DMA aus dem Speicher liest, muß zuvor 
mit der Routine "CachePreDMA ()" der Cache "geflushec'” werden. 
Schreibt man hingegegen Daten über DMA in den Speicher, muß 
man danach die Routine *CachePostDMA (}" aufrufen. 


Flags für DMA-Cache-Funktionen: 


Bit Name Funktion 

1 Continue alten Vorgang fortsetzen (für CachePreDMA) 

2 NoModify wenn 1, dann wird der Speicher nicht aktualisiert 

3 ReadFromRAM auf 1 setzen, wenn Daten aus dem RAM auf ein 
Medium geschrieben werden 
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1.12 Die FPU-Programmierung 


Die Zeit der "normalen" Amigas ist schon längst abgelaufen. Die 
meisten besitzen entweder eine Turbokarte oder ein neues Amiga- 
Modell. Die Geräte arbeiten mit einen Prozessor der neuen 
Generation. Diese sind nicht nur schneller, enthalten einen 32-Bit 
Datenbus und noch zusätzliche Adressierungsarten, sondern als 
wesentlichste Verbesserung ein Coprozessor-Interface. Das Interface ist 
nur bei den 68020er und 68030er vorhanden. Beim 68040er und 
68060er gibt es keine Schnittstelle, dort wurden die FPU und MMU 
gleich in den Chip integriert. Durch dieses Prinzip ist die CPU in der 
Lage seinen eigenen Befehlsvorat zu erweitern. Es sind insgesamt 
65536 Befehle möglich. Also mehr als genug. Für die Kom- 
munikation von 68020/68030 und Coprozessor stellt die CPU extra 
Befehle zur Verfügung. Der zentrale Befehl ist "cpGen" (co-prozessor 
GENeric), der es ermöglicht, ein 16-Bit breites Befehlsword zusammen 
mit evtl. benötigten Parametern an einem Coprozessor zu schicken 
(für FPU = 001). In einem 68020/68030er-System lassen sich 
maximal acht Coprozessoren verwalten. Dieser Maximalwert ergibt 
sich aus einem 3-Bit-ID-Feld, das in einem Coprozessor vorhanden ist 
und angibt für welchen Coprozessor der Befehl bestimmt ist. Über 
diese Codiertechnik brauchen Sie sich nicht den Kopf zerbrechen, 
dafür ist die CPU zuständig. 


Für dieses Interface wurden von Motorola die Mathecoprozessoren 
MC68881/MC68882 (FPU = Floating Point Units) und die PMMU 
(Paged Memory Management Unit) entwickelt. Die FPUs sind pin- 
kompatibel und besitzen auch den gleichen Befehlssatz. Sie können 
diese gegeneinander austauschen (Quarz nicht vergessen). Allerdings 
ist die 68882-FPU bei gleicher Taktfrequenz im Durchschnitt um 50 
Prozent schneller als die 68881-FPU, weil sie einige Befehle 
gleichzeitig ausführen kann. Die im 68040er integrierte FPU verfügt 
leider nicht über den gleichen Befehlssatz wie die beiden anderen. 
Der Grund ist, laut Motorola, das in der Regel nicht alle Befehle 
genutzt werden, und so nur die wichtigsten enthalten sind, welche 
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aber umso schneller ausgeführt werden. Die restlichen Befehle 
müssen durch Software emuliert werden (68040er.library). Dieses 
geschieht aber immer noch schneller als bei den normalen FPUs. 


Normalerweise erledigt die CPU in unserem Rechner alle Aufgaben 
alleine. Dafür stehen ihr bestimmte Befehle zur Verfügung. Doch 
leider kann der Prozessor immer nur im Integerformat (ganze Zahlen, 
wie 2 oder 5 oder 34 usw.) rechnen. Für andere Zahlen wie 3,14 
müssen umständliche Routinen programmiert werden, was die 
Rechenzeit herabsetzt. Für diese Kommazahlen, welche wir Fließ- 
kommazahlen nennen, wurden die Matheprozessoren entwickelt. Sie 
besitzen einen eigenen speziellen Befehlssatz. Die Adressierung der 
Daten und Befehle wird aber weiterhin von der CPU durchgeführt. 
Das heißt, das wir die FPU-Befehle direkt in unseren Maschinencode 
einfügen können. 


1.12.1 Fließkommazahlen 


Bei einer Fließkommazahl wird die Zahl in Exponentialschreibweise 
dargestellt. Für 1256 schreibt man dann 1,256 x 10°3. Diese Zahl 
teilt man in Mantisse und Exponent ein. Diese sind hier: 


1,256 = Mantisse 1073 = Eiponent 
weitere Beispiele: 

I4,345 => 3,8345 x 10°] 

136,2 => L362 x 102 

07866 => 766 x10"-] 
Die Beispiele bezogen sich auf unser "normales" Zahlensystem, wo 
der Exponent immer ein vielfaches von 10 ist. Unser Rechner kennt 


aber nur die Zustände O bzw. 1 und arbeitet deswegen im Binär- 
system. In diesem System bezieht sich der Exponent auf die Basis 2. 
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Zehnersystem: Zweiersystem (Binär): 

19 2= 0,01 22 =025 -)\22, AU 
11-91 2 = 05 

10°0 = 1 208 — 

io 1 & @ 21 =. 

10°2 = 100 22 =4 


Eine Fließkommazahl in Exponentialschreibweise kann wie folgt aus- 
sehen: 


12,536 => 1,2560 x 1071 
oder 12,360 => 1256 x 100 
oder 12,36 => 1253,6x 10-1 


Aus diesem Grund wurde die normalisierte Darstellung eingeführt. 
Dabei darf sich die Mantisse nur zwischen 1 und der Basis des 
Zahlensystems bewegen. 


Zehnersystem: Zweiersystem: 
von 1 bis 9,.9999,, von 1 bis 1.9999,... 


Im Zweiersystem ist die Zahl vor dem Komma immer 1. Die FPU läßt 
die 1 vor dem Komma im SingleReal-Format einfach weg, hat da- 
durch ein Bit mehr Genauigkeit, doch dazu später weiteres. 


Möchte man eine Binärzahl in eine Dezimalzahl umrechnen, so geht 
das wie folgt: 


0 t ( 


1x2”0 + 1x2”-1 + 0x2”-2 + 1x2”-3 
1 +05 + DD + 0,125 
1,625 


1.109 


11.01 1x2”1 + 1x2”0 + 0x2”-1 + 1x2”-2 
2 +71 + OO + 0,25 


3,29 
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Beim zweiten Beispiel kann die Zahl auch als 11.01 x 2”O dargestellt 
werden. Denn 2° 1 ist, wie wir wissen, 1. Und 11.01 x 1 ist 11.01. 
Diese Zahl ist aber nicht normalisiert, weil sie einen Wert > 1 vor 
dem Komma hat. Wir formen die Zahl einfach um in 1.101 x 2°1 
und schon ist die Bedingung erfüllt. Diesen Trick kann man mit jeder 
Zahl machen. Wandert das Komma eine Stelle nach links, wird der 
Exponent um eine Potenz erhöht. Verschiebt man das Komma um 
eins nach ‚rechts, wird der Exponent um eine Potenz erniedrigt. 
Wichtig ist, daß immer eine 1 vor dem Komma steht. 


Zum Abschluß noch das Umwandeln einer Dezimalzahl in eine 
Binärzahl: 
19,25 8 +2 + 0,25 
1x2°3 + 1x2’1 + 1X2°-2 
1010.01 


=> 1010.01 normalisieren = 1.01001 x 2”3 


Bestimmt werden Sie jetzt schon einen Schreck bekommen haben. 
Aber keine Angst, mit dem Umformen brauchen Sie sich nicht zu 
beschäftigen. Dieses wird automatisch von der FPU erledigt, wie wir 
im nächsten Abschnitt noch sehen werden. 


1.12.2 FPU-Fließkommaformat (IEEE) 


Die FPU kann verschiedene Datenformate verarbeiten. Diese lassen 
sich in drei Gruppen einteilen: 


- Integer 


- Fließkomma 
- BCD (gepackte Dezimalzahlen) [.p] 
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Die ersten beiden Gruppen lassen sich nochmals in drei Gruppen 
einordnen. Bei den Integerzahlen sind die bekannten Formate: 


- Byte [.bl => 1 Byte (8 Bit) => +/- 128 
-Word [.w] => 2 Bytes (16 Bit) => +/- 32.768 
- Longword [.]| => 4 


Bytes (32 Bit) => +/- 2.147.483.648 


Für das Fließkommaformat stehen folgende Arten zur Verfügung: 


- Single Precision (einfache Genauigkeit) [.5] 
- Double Precision (doppelte Genauigkeit) [.d] 
- Extended Precision (erweiterte Genauigkeit) [.x] 


Das Datenformat wird allgemein mit Befehl.f gekennzeichnet, welche 
oben aufgeführt wurden. Intern rechnet die FPU immer mit Extended 
Precision. Davon merken Sie als Programmierer aber nichts. Dafür 
exestiert die APU (Arithmetic Processor Unit). Wird eine Zahl in 
einem anderem Format übergeben (z. B. Longword oder Single 
Precision), so wird sie automatisch von der APU in das Extended- 
Precision-Format gewandelt. 


Jede Hießkommazahl besteht aus drei Teilen: 


- Mantisse 
- Exponenten 
- Vorzeichen für Mantisse 


Das Vorzeichen für den Exponenten wird durch einen Grenzwert 
angegeben. Dieser wird als Bias bezeichnet und ist für jedes Fließ- 
kommaformat unterschiedlich. Bei Single ist dieser 127. Liegt der 
Exponent über diesen Grenzwert (Bias), so ist er positiv andernfalls 
negativ. Die Mantisse ist eine Zahl zwischen O und 1, welche mit 
dem Exponenten multipliziert die eigentliche Fließkommazahl ergibt. 
Die drei Fließkommaformate unterscheiden sich nur in der Größe der 
Mantisse bzw. dem Exponenten, wie nachfolgendes Bild verdeutlicht. 
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Bild 1.12.2.a 
31 u.76€6 8, a 
FP-Single 
24 Bit Mantlisse 
Fee [Taerar 
Basel 
ee den Komma 
63 62 52 51 ® 
vpan,eıt | ©2 Bit Sunptteee | keine v vor 
C.XKR) keine 1 vor 
den Komma 
Tr rs - TIEEE Ex ded 
-Extende 
64 Bit Manti 
Laer [ee ine 1 vor 
95 9 93 92 91 88 79 68 67 8 





BEBE 12 Bit Exp. DITy 68_Bit Mantisse ]n@cked-BCD 
(3 BCD Zahlen) (17 BCD-Zahlen) 1 BCD Zahl 


V = Vorzeichen der Mantisse 
VE = Vorzeichen vom Exponent (nur BCD) 
I = zwei interne Bits (normal Null, 
außer bel +/- unendlich u, Rechenfehler) 


Wie Sie an dem Bild erkennen können, gibt es neben den drei IEEE- 
Formaten noch das FFP-Format (Bias = 65). Es handelt sich um ein 
Programmpaket von Motorola und ermöglicht eine schnelle 
softwaremäßige Lösung von Fließkommaaufgaben nur mit der CPU. 
Der Amiga nutzt das Format in seinen Mathe-Libraries. Leider 
versteht die FPU ausschließlich die IEEE-Formate, so daß Sie das FFP- 
Format erst in das IEEE-Single-Format umwandeln müssen. Natürlich 
nur, wenn Sie zum Beispiel die alten Mathe-Libraries durch neue 
ersetzen möchten. Doch dazu später mehr. 


Wir wollen zum Beispiel die Zahl 1 in das SinglePrecision-Format 
umwandeln. Dazu müssen wir noch beachten, daß im Single- und 
Double-Format die Zahl vor dem Komma immer weggelassen wird. 
Denn in der normalisierten Darstellung ist die Zahl immer 1 und 
kann somit aus Platzgründen weggelassen werden. Im FFP-Format, 
das dem Single-Format gleicht, wird die 1 vor dem Komma 
durchgezogen, ebenso bei den Extended-Fließkommazahlen. 
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Dezimalzahl in Single-IEEE: 


!(Dezimal) = 2°0 = 1.0. x 2°0 (Binär) 


=> Mantisse = 0, weil I vor dem Komma weggelassen wird und danach nur Nullen 
folgen 

=> Exponent = 127 (wegen 20) + Bias (127) => [0+127] 

=> Vorzeichen = 0 (weil Positive Zahl/Mantisse) 


Single-Format der FPU: 

S = Vorzeichen Mantisse [0] 

E = Exponent [127=$7F=%01111111] 

M = Mantisse [0] 
SEEEEEEEEMMMMMMMMMMMMMMMMMMMMMMM 
9 11:32:22 11808 8 B EBERLE! EL RE HERD OO 
=> $3f 80 00 00 


Damit lautet die dezimale Zahl 1 im Single-IEEE-Format (32 Bit) 
$3f800000. 


Möchte man eine Single-IEEE-Zahl zurück in eine Dezimalzahl 
wandeln, so geschieht das wie folgt: 


Singel-IEEE = $431C0000 
/) ın Bits umgewandelt und unter die Formatschablone gelegt: 


SEEEEEEE EMMMMMMM MMMMMMMM MMMMMMMM 
01000011 00011100 00000000 00000000 
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2) Werte für Mantisse, Exponent und Vorzeichen ermitteln: 


Mantisse = 0011100 00000000 00000000 
Exponent = 10000110 = $86 
Vorzeichen = 0 


I) Echte Werte berechnen: 


586-127 = $7 => 2'7 
1.0011100 00000000 00000000 


Exponent 
Mantisse 


=> 1.00111 x 2°7 ist das selbe wie: 


=> 1x2°7 + Ox2”6 + 0x2”5 + 1x2°4 + 1x2°3 + 1x2°2 
=> 125 + © + 0 + 16 +8 + 4 


=> Ergebnis = 156 oder 1.56 x 10” 2 


Nach soviel Rechnerei verspüren Sie bestimmt keine Lust mehr zum 
weiter lesen. Aber keine Angst, wie schon erwähnt, übernimmt das 
alles die APU. Sie können die Zahlen ganz normal mit einem 
"fmove.| Dx,Fpx"-Befehl im Integerformat der FPU übergeben und 
die APU wandelt diese intern in eine Extended-Fließkommazahl. 
Genauso können Sie mit einem "fmove.l FPx,Dx"-Befehl diese 
Fließkommazahl als Integer zurückholen. 


Zum Abschluß noch zwei CPU-Beispiele die eine FFP-Zahl des Amigas 
in eine Single-IEEE Zahl umwandelt. 
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;-- DO = FFP-Zahl (Amiga-Matheformat) 
—- => DO = Single-IEEE-Zahl 
FFPtoIEEE: 
move.b dO,d1 ; FFP-Exponent/Vorzeichen nach dI 
add.| dO,dO ; FFP-Mantisse um eine Stelle nach links 
; damit 1 vor dem Komma wegfällt für IEEE 


bceir.| #7,d1 ‚ Vorzeichen von FFP-Mantisse löschen 
add.b #62,d1 ; damit Biasdifferenz addiert werden kann 
; (127-65=62) 


move.b d1,d0 ; Single-IEEE-Exponent nach DO 
moveq #9,d2 ; DO um 9 Stellen nach rechts rotieren 
ror.|l d2,dO ; damit Exponent oben 

rts 


- DO = IEEE-Zahl (FPU-Matheformat) 
—- => DO = FFP-Amigazahl 
IEEEtoOFFP: 


moveq #9,d2 ; DO um 9 Stellen nach rechts rotieren 
rol.| d2,dO ; damit Exponent unten 

move.b d0O,d1 ; IEEE-Exponent/Vorzeichen nach dI 
ror.| #1,d0 ‚ Mantisse um eine Stelle nach rechts 


bset.! #31,d0 ; und Vorkommastelle setzen 

sub.b #62,d1 ; Biasdifferenz zum FFP-Format abziehen 

and.b #$80,d0 ; alten Exponenten löschen u. Vorzeichen lassen 
or.b d1,d0 ; FFP-Exponenten setzen 

rts 
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1.12.3 FPU-Befehlssatz 


Die Befehle der FPU gleichen denen der CPU, nur das sie nicht über 
so viele Adressierungsarten verfügt. FPU-Befehle können beliebig mit 
"normalen" CPU-Befehlen gemischt werden. Die CPU übernimmt 
dabei die Adressierung der FPU-Befehle, überträgt dazu auch die 
Daten und arbeitet danach parallel zu FPU weiter. Die Ausnahme 
bilden Befehle, bei denen Daten von der FPU zur CPU oder in den 
Speicher transportiert werden. Hier muß die CPU warten bis der Wert 
bzw. das Ergebins der FPU vorliegt. Ansonsten würde die CPU mit 
falschen Werten weiter arbeiten. 


Alle Befehle der FPU fangen mit einem "f" an, wie zum Beispiel 
"fmove.| dO,fpO". Es existieren acht Fließkommadatenregister (FPO bis 
FP7) mit einer Breite von 80-Bit und drei Kontrollregister 
(FPCR,FPSR,FPIAR). Der gwünschte Datentyp (.b,.w..l,.5,.d,.x,.p) wird 
einfach wie bei den CPU-Befehlen an den FPU-Befehl gehängt (Z.B.: 
fmove.s). 


Als erstes folgt hier erstmal eine Auflistung aller FPU-Befehle: 


FABS <ea>,FPx b,w,ls absoluter Betrag 
FABS FPn x absoluter Betrag 


-FrFABS+ <ea>,FPx b,w,l,s gerundeter Absolutbetrag 


FACOS** <ea>,FPx b,w,l,s ArcusCosinus (Cosinus”-1) 
FADD <ea>,FPx b,wls Addition 


: FFADD+ <ea>,FPx b,w.l,s Addition und Runden 


FASIN** <ea>,FPx b,w.ls ArcusSinus (Sinus”-1) 

FATAN** <ea>,FPx b,w,l,s  ArcusTangens (Tangens”-1) 
FATANH**<ea>,FPx b,w,ls ArcusTangens Hyperbolicus 
FBec <label> . b,w,l wie Bcc (aber FPSR statt CCR) 
FCMP <ea>,FPx b,w,ls wie CMP (aber FPSR statt CCR) 
FCOS**  <ea>,FPx b,w,ls Cosinus 

FCOSH** <ea>,FPx b,w,l,s Cosinus Hyperbolicus 

FDBcc Dn,<label> wie DBcc (aber FPSR statt CCR) 
FDIV <ea>,FfPx b,w,l,s Division 


-FrDIV+  <ea>,FPx b,w,ls Division und Runden 


FETOX** <ea>,FPx b,w,l,s Bildung von e” <ea> 
FETOXM1**<ea>,FPx b,w,l,s Bildung von e” <ea>-I1 
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FGETEXP** <ea>,FPx 


FGETMAN** 
"ENT < 
«FINTRZ** < 


<ea>,FPx 
ea>,FPX 
ea>,FPx 


FLOG10** <ea>,FPx 

FLOG2** <ea>,FPX 
FLOGN**  <ea>,FPX 
FLOGNPI1** <ea>,FPX 
FMOD** <ea>,FPX 
FMOVE <ea>,FPX 
FMOVE FPx,<ea> 


b,w‚l,s Exponent von <ea> 
b,w‚,l,s Mantisse von <ea> 
b,w,l,s Auf ganze Zahl Runden 
b,w,l,s Nachkommastellen abtrennen 
b,w,l,s Logarithmus zur Basis 10 
b,w,l,s Logarithmus zur Basis 2 
b,w‚l,s Natürlicher Logarithmus 
b,w,l,s Natürlicher Logarithmus + 1 
b,w,l,s Rest von Division => FPx/<ea> 
b,w,l,s Move nach FPx-Register von <ea> 
b,w,l,s Move von FPx-Register nach <ea> 


FMOVE FPx,FPx x,p Move von FPx nach FPx 

FMOVE FPx,<ea>(#k) p Move Dezimalzahl nach <ea> mit 
Rundung nach Stelle #k (-64 bis 17) 

FMOVE FPx,<ea>(Dn) p Move Dezimalzahl nach <ea> mit 


FFMOVE+ <ea>,Fpx 


FFMOVE + 
FMOVECR** 
FMOVEM 
FMOVEM 
FMUL 
FrFMUL+ 
FNEG 
FrNeg+t 
FNOP 
FREM** 
FRESTORE* 
FSAVE* 
FSCALE** 
FScc 
FSGLDIV* * 
FSGLMUL** 
FSIN** 


FPx,<ea> 
#xx,FPx 
<ea> ,-(sp) 


Rundung nach Stelle Dn (-64 bis 17) 
b,w,l,s wie FMOVE mit Rundung 
b,w,l,s wie FMOVE mit Rundung 
X Konstante xx nach FPx (S. Tabelle) 
x MOVEM für FPx-Register auf Stack 


(sp)t,<ea> x MOVEM für FPx-Regsiter von Stack 


<ea>,FPx 
<ea>,FPx 
<ea>,FPx 
<ea>,FPx 


<ea>,FPx 
(sp)+ 
-(SP) 
<ea>,FPx 
<ea> 
<ea>,FPx 
<ea>,FPx 
<ea>,FPx 


b,w,l,s Multiplikation 
b,w,l,s Multiplikation mit Rundung 
b,w‚,l,s Negieren von <ea> Ergebnis in FPx 
b,w,l,s wie FNEG mit Rundung 
wie NOP (No Operation) 
b,w,l,s IEEE-Rest holen 
FPU-Status von Stack zurückholen 
FPU-Status auf Stack retten 
b,w‚,l,s Exponent scalieren 
wie Scc (aber FPSR statt CCR) 
b,w,l,s Division mit einfacher Genauigkeit 
b,w,l,s Multiplikation mit einf. Genauigkeit 
b,w‚l,s Sinus 


FSINCOS** <ea> ,‚FPx:FPx b,w,‚l,s Sinus und Consinus von <ea> 


FSINH** 
FSORT 
FrSQRT+ 
FSUB 
FrsUB+ 
FTAN** 
FTANH** 
FTENTOX** 
FTRAPcc 
FTST 
FTWOTOTX** 


<ea>,FPx 
<ea>,FPx 
<ea>,FPx 
<ea>,FPx 
<ea>,FPx 
<ea>,FPx 
<ea>,FPx 
<ea>,FPx 


<ea> 


Sinus = 1.FPx Cosinus = 2.FPx 
b,w,l,s Sinus Hyperbolicus 
b,w‚l,s Quadratwurzel von <ea> 
b,w,l,s wie FSQRT mit Rundung 
b,w‚l,s Subtraktion 
b,w,l,s Subtraktion mit Rundung 
b,w,l,s Tangens 
b,w,l,s Tangens Hyperbolicus 
b,w‚,l,s 10° <ea> 

wie TRAPcc (aber FPSR statt CCR) 
b,w‚,l,s wie TST (aber FPSR statt CCR) 


<ea>,FPx b,w,‚ls 2”<ea> 
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<ea> = Dn [DO bis D7] oder (Ax) [AO bis A7] 

oder FPx [FPO bis FP7] dann nur Datenformat: .x 

kennt nur die 68040/60er-CPU 

nicht vorhanden im MC68040/60 (werden über Library emuliert) 
priviligierter Befehl 


Es folgt eine Auflistung der Condition Codes für die Befehle FBcc, 
FDBcc, FScc und FTRAPcce: 


(cc) Bedeutung 

t wahr 

f falsch 

eq gleich 

ne ungleich 

gt größer als 

It kleiner als 

ge größer gleich 

le kleiner gleich 

gle verzweige bei Division durch Null 
ngt nicht größer als 

nit nicht kleiner als 

nge nicht größer oder gleich 
nie nicht kleiner oder gleich 


Die Konstanten für den "fmovecr #xx,FPx"-Befehle dürfen natürlich 
auch nicht fehlen: 


#rax__Konstante 
$00 Pi (3,14...) 
$0B log10(2) 
$0C e 

$0D log2(e) 
$0E log10l(e) 
$0F 0,0 

$30 In(2) 

$31 In(10) 
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532 | 
633 1 
$34 1 
635 1 
$36 108 
$37 10”16 
$38 10°32 
$39 1064 
$3A 10°128 
$3B 10”256 
$3C 10°512 
$3D 10° 1024 
$3E 10°2048 
$3F 10”4096 


Nach soviel Theorie werden wir jetzt ein paar Befehle anwenden. Wir 
wollen dazu eine Integerzahl in eine Singel-IEEE-Zahl umwandeln. 
Dafür reicht uns der "fmove"-Befehl. Denn, wenn wir eine Zahl 
mittels "fmove.l" in ein FPx-Register schreiben, wird diese 
automatisch von der APU der FPU in das Extended-Format 
gewandelt. Danach brauchen wir diese Zahl nur wieder mittels eines 
"fmove.s"-Befehls zurück in ein Datenregister holen. Dieses geht 
natürlich nur im Single-Format, weil die Datenregister hier 32-Bit 
breit sind. 


Um alle folgenden Beispiele testen zu können, müssen Sie das Ihrem 
Assembler mitteilen, daß Sie die FPU programmieren möchten. Die 
nötige Einstellung bzw. Befehl entnehmen Sie bitte ihrem Handbuch 
zum Assembler. 
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Hier nun das Assembler-Listing: 


;--- Hexzahl (DO) in Single-IEEE (DO) --- 
fmove.| dO,fp0 ; .| für Integer nach FPx 
fmove.s fp0,dO ; .s für Singel-IEEE nach Dx 
rts 


Das ganze noch in umgekehrter Reihenfolge: 


;-- Single-IEEE (DO) in Hexzahl (DO) --- 

| fmove.s dO,fpO ; .s für Single-IEEE nach FPx 
fmove.| fp0,dO ; .| für S-IEEE als Integer nach Dx 
rts 


Jetzt wollen wir die Rechnung 2x ausführen, Dazu benutzen wir den 
"Atwotox FPx "Befehl, 


;-- Routine für 2 hochx -- 
- DO = x (kleine Werte) --- 
—- => DO = Ergebnis = 


weiHochX: 
fmove.| dO,fpO ; „| für Integer in IEEE 
ftwotox fpO ; Rechnung: 2°x im IEEE-Format 
fmove.| fp0,dO ; IEEE als Integer nach => DO 
rts 
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Bei den transzendenten Funktionen (Sinus, Cosinus,Tangens etc.), 
rechnet die FPU immer im Bogenmaß (Radiant = rad). Wie man 
diese Werte umrechnet zeigen folgende Schritte: 


/) Grackah/ übergeben 
2) Umrechnen in das Bogenmaß (rad) 


rad = (pi * c) / 180 pi 
C 
rad 


ie. 
Winkel als Gradzahl Z.B. 90 
Bogenmaß3 des Winkels c 


3) Rechnung ausführen 
(sin/cos/tan etc.) 


4) Ergebnis der Operation (z.B Sın von 90 = ]) 


7) Bogenmaß umrechnen in Grad! 


Winkel vom Bogenmaß 
Bogenmaß 
3, 14 


c = (rad * 180) / pi C 
Ä rad 
pi 


2) Ergebnis liegt als Graokzahl vor, 


In Assembler kann dieses zum Beispiel so realisiert werden: 


--- Sinus von X Grad ausrechnen 
;-- DO = Gradzahl (0,22,45,90,91 etc.) 
—- => DO = (Sinuswert * 100) 


GetSinus100: 
fmove.| dO,fpO ; Gradzahl in IEEE 
fmovecr #0,fp] ; Pi nach FPO 
fmul.x fp1,fpO ; Pi * Grad 
fdiv.x #180,fpO ; durch 180 Grad = radiant v. Gradzahl 


Seite 160 


fsin.x fpO ; Sinus vom Radiant der Gradzahl 
fmul.x #100,fpO ; mal 100, damit Zahl größer 1 
fintrz.x fpO ; Kommastellen abtrennen 
fmove.| fp0,dO ; Ergebnis als Integer nach DO 
rts 


-- Beispiel: (Sinus von 1,05 rad = 60 Grad) --- 
-- mal 100 u. auf Ganze Zahl runden + in Hex --- 
Sinus von 60 Grad = 0,866 (mal 100 = 86,6)--- 


m— wen 0 en ne nn 
' 


move.| #105,dO ; immer 3 Stellen übergeben für 1.05 
fmove.| dO,fpO ; in Single-IEEE 

fdiv.x #100,fpO ; durch 100, wegen x.xx 

fsin.x fpO ; Sinus vom Radiant 

fmul.x #100,fpO ; mal 100 damit xxx.xxx 

fintrz.x fpO ; Kommastellen abschneiden 

fmove.| fpO,dO ; Single-IEEE zurück als Integer 

rts 


Da die Sinuswerte nicht größer als maximal 1 werden und das die 
kleinstmögliche Integerzahl ist die unsere CPU versteht, multiplizieren 
wir das Ergebnis mit einen Faktor (hier 100). Ansonsten würde wir als 
Ergebnis immer 1 erhalten. 


Das waren jetzt einige kleine Beispiele um die Befehle kennen zu 
lernen. Es fehlt noch die Beschreibung der drei Status-Register (FPSR, 
FPCR und FPIAR). 


Das Statusregister FPSR: 


mu FP-Condition-Codes----------—- _ ---------FP-Quotient------—- 
Bit: 31 30 29 28 27 26 25 24 Bit: 23 22 21 20 19 18 17 16 
000 ON Z I NAN S _FP-Quotient 


._—| —,—usnsimmunmnummunuu— nn nun menu nn nun m nn ._.—————.,em——uuenntnmeninnnns—enuen- 
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m Exception Status 
Bt: 5 14 133 12 11 10 09 08 
BSUN SNAN OPERR OVFL UNFL DZ INEX2 INEX] 


— Accrued-Exception-Status--------------- 
Bit: 070 06 05 04 03 020100 
IOP OVFL UNFL DZ INEX 0 0 0 


Erklärung: 


Die Condition-Codes werden von den Befehlen FBcc, FDBcc, FScc, 
FCMP und FTST abgefragt und von allen FPU-Operationen (außer 
FMOVE FPx,<ea>) entsprechend gesetzt. Die einzelnen Bits haben 
folgende Bedeutung: 


negatives Ergebnis 

Ergebnis ist Null 

Ergebnis ist plus oder minus unendlich 

ungültige Zahl als Ergebnis (Null-Division/Wuzel von 
negativer Zahl) 


N 
Z 
| 

N 


AN 


Bei einigen Operationen wird der Quotient im FPSR abgelegt (Bits 16 
bis 22, Vorzeichen ist Bit 23). 


Die Exception-Status-Bits zeigen die im Fehlerfalle aufgetretene 
Exception-Ursache an. Anlich wie bei der CPU. Die Ursachen können 
folgende sein: 


BSUN = Sprung bei selbstdefinierter Ausnahme 

SNAN = keine Zahl, wird gesetzt bei Laden von Buchstaben bzw. 
Zeichen in ein FPx-Register 

OPERR = Fehler im Operanden 

OVFL = Überlauf, Ergebnis ist zu groß 

UNFL = Unterlauf, Ergebnis zu klein, kann nicht dargestellt werden 
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DZ = Division durch Null 
INEX2 = Operation ungenau 
INEX1 = falsches Dezimalformat übergeben (.p) 


Bei dem unteren Byte (Accured-Exception-Status) kann man einstellen 
welche Bits bei einer Exception stehen bleiben sollen. Diese können 
dann nur durch den Programmierer zurückgesetzt werden (schreiben 
ins FPSR-Register). Die Funktion ist die gleiche wie im Status-Byte. Bei 
IOP wird eine Exception für SNAN und OPERR erlaubt. 


Das Controll-Register FPCR: 


nn Exception-Maske (Freigabe)----------------—--------- 
Bit: 15 14 3 12 11 1009 08 
BSUN SNAN OPERR OVFL UNFL DZ INEX2 INEX] 


---Rundungsmodus/Genauigkeit------ 
Bit: 07 06 05 04 03 02 01 00 
RPREC RND 0000 


Welche Exception zugelassen werden, ist abhängig von der Maske im 
oberen Byte (Bits 8 bis 15). Tritt eine Ausnahme ein, so wird das 
entsprechende Bit im Status-Byte des FPSR-Registers gesetzt. 


Die Bits 7 und 6 bestimmen die Rundungsart für die entsprechenden 
FPU-Befehle (FINT etc.). Die Funktion ist folgende: 


Bit 7 6 Funktion 
0 O0 Runden zur nächsten Zahl 
0 1 gegen Null runden 
1 0 Rundung gegen Minus-Unendlich 
1 1 Rundung gegen Plus-Undendlich 
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Außerdem wird mit Hilfe der Rundungsbits bestimmt, wie eine Zahl 
gerundet wird, wenn sie in ein anderes Format gewandelt werden 
soll, welches nicht der eingestellten Genauigkeit entsprechen kann. 
Die Voreinstellung ist OO (Rundung zur nächsten Zahl). 


Die Bits 5 und 4 bestimmen die Genauigkeit der Rundung. Wird ein 
Ergebnis in ein anderes Format gespeichert, rundet die APU in der 
FPU unabhängig von der Einstellung. Die Vorstellung ist 00 
(Extended). 

Bit 5 4_Funktion 

00 Extended (erweiterte Genauigkeit) 
0 1 Single (einfache Genauigkeit) 

10 Double (doppelte Genauigkeit) 

1 1 nicht definiert 


Das Befehlsadressregister FPIAR: 


In dieses Register wird vor der Ausführung eines FPU-Befehls die 
Adresse geladen, unter die es im Speicher zu finden ist. Vergleichbar 
mit dem Programmcounter der CPU. Da die CPU parallel zur FPU 
arbeitet und im Fehlerfalle (Exception) nicht mehr in der Lage wäre, 
die Adresse der Fehlerhaften-Operation ausfindig zu machen, kann 
über dieses Register die Adresse ermittelt werden. 


Auslesen kann man die Register zum Beispiel auf folgende Weise: 


fmovem fpiar,dO ; Befehlsadresse des FPU-Befehles nach DO 
fmovem fpsr,d1 ; FPU-Status-Register nach D1 
fmovem fpcr,d2 ; FPU-Controll-Reg. nach D2 


Das ganze funktioniert natürlich auch umgekehrt. 
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1.12.4 FPU-Beispielprogramm 


Zum Abschluß noch ein Beispielprogramm, das ein Fenster auf alte 
Weise öffnet (nicht über TAGs) und darin, mit Hilfe der FPU, eine 
Sinuskurve zeichnet. Alle nötigen Formeln und Erklärungen finden Sie 
im nachfolgenden Bild bzw. im Listing. Viel Spaß beim experimen- 
tieren. Das Programm kann leicht zu einem Mathematikprogramm 
ausgebaut werden. Das Abfragen einer FPU im System wird im 
Multitasking-kapitel erklärt. 


Bild 1.12.4.a 


Y 


A=Fmax <Faktor) 










(Y,xX) 


20,205 
(YStartPos , Mitte) 


e.XStartPos) 115,688 


(YMitte.XEndPos) 


x 


+pi 








288,385 
(YEndPos ,XMitte) 


geg! für Koordinatenkreuz x = X+1 
YStartPoszs = 38 / YEndPoz = 2B8 


xXStartPos = 18 / XEndPos = 688 
errechnen: 


An! ELRnE FERNE OB TEE DRS BEWMEFTETITT OS 
Yfchze=- (288-399) 72+998=-11 
ee 
Xfchse= (688-18)/72+18=385 


Tmax= stn98®= 1 => fur größere Werte => Faktor (Fmax) 
Fmax=<YEndPos-YStartPos)/2 

=(288-38)7/72 

=85 


Yoffset=Fnax®#sin XStart=-pi=8°-18 
Y=mnitterrörtrset xEnd=+rpl= =368°= 688 
Kreis=-2fi=-sinuskurve 
Sinus lLänge=XEnd-XStart 
=598,wenn X=X+1 
Sinusschrittweite=2pi/598 
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Har regrundlagen 


lea IntName,al 

moveq #0,d0 

move.l 4,36 

jsr -552(a6) ; Intuition öffnen 

move.l dO,IntBase 

beq.w Ende 

lea.| GfxName,al 

moveq #0,d0 

move.| 4,36 

jsr -552(a6) ; Graphics öffnen 

move.|l d0O,GfxBase 

beq.w Ende 

lea OWArgs,a0 ; WindowArgumente 

move.l IntBase,a6 

jsr -204(a6) ; OpenWindow () 

move.|  dO,WindowAdresse 

beq.w Ende 

move.|l dO,a0 ; WindowAdresse 

move.| 50(a0),RastPort ‚ RastPortAdresse merken 
moveg #1,d0 ; Vordergrundfarbregister = 1 
bsr.w SetAPen 

move.| #305,d0  X-Pos. 

moveq #30,d1 , Y-StartPos. 

bsr.w SetStartPunkt 

move.|l #305,d0 ; X-Pos. 

move.| #200,d1 ; Y-EndPos. 

bsr.w DrawLinie ; Y-Achse zeichnen (von YStart nach YEnd) 
move.| #600,d0 ; X-EndPos. 

movegq #115,d1 , Y-Pos. 

bsr.w SetStartPunkt 

moveq #10,d0 ; X-StartPos. 

movegq #115,d1 ; Y-Pos. 

bsr.w DrawLinie ; X-Achse zeichnen (von XEnd nach XStart) 
moveq #3,d0 ; Vordergrundfarbregister = 3 
bsr.w SetAPen 
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fmovecr #0,fpO 


fmove.x fpO,fp7 
fadd.x  fp7,fp7 
fdiv.x  #590,fp7 
fnegx fpO 
moveq #10,d0 
SinLoop: 
fsin.x fpO,fp1 
fmul.x  #85,fpl 
fintrz.x fp1 
fmove.l fp1,d1 
add.w #115,d1 
bsr.b DrawLinie 
fadd.x  fp7,fpO 
addq.w #1,d0 
cmp.w #600,d0 
bne.b SinLoop 


ndl 


; Konstante Pi nach FPO 


; mal 2 = 2Pi = 360 Grad = volle Sinuskurve 
; 590 Schritte (XEndPos-XStartPos) 

; Start bei -Pi 

; XStartPos. 


; Sinus berechnen 

; Dehnen um Faktor 85 (YEndPos.-YStartPos/2) 

; Nachkommastellen abschneiden = YSinusOffset 
; YSinusOffset nach D1 als Integerzahl (.|) 

‚ addiere YPos der Y-Achse 

; Linie v. alten Pkt z. neuen Pkt zeichen 

; Sinuswert einen Schritt weiter 

;X-Pos. +1 => New X Ziel 

; XEndPos. erreicht ? (590 Schritte) 


;--- auf Schließen des Fensters warten --- 


’ 


WindowAdresse,a0 


WindowAdresse,dO 


move.l 

move.l 86(a0),a0 

move.l| 4,36 

jsr -384(a6) 
i-- Programmende --- 
Ende: 

move.l 

begab Ende_2 

move.| dO,a0 

move.|l IntBase,a6 

jsr -72(a6) 
Ende _2: 

move.|l GfxBase,dO 

begab Ende _3 

move.| dO,al 

move.l 4,36 

jsr -414(a6) 
Ende 3: 

move.|l IntBase,dO 

beq.b Ende 4 

move.| d0O,al 

move.| 4,36 

jsr -414(a6) 
Ende 4: 


rts 


; WindowUserPort 


; WaitPort () 


; WindowHandle 


; CloseWindow 


; CloseLib () 


; CloseLib () 
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a DO/D1 = neuer X,Y-RastPortstart -- 
SetStartPunkt: 

movem.| dO-d1,-(sp) 

move.|l RastPort,al 

move.l GfxBase,a6 


jsr -240(a6) ; Move () 
movem.| (sp)+,dO-d1 
rts 


DrawLinie: 
movem.| dO-d1,-(sp) 
move.l  RastPort,al 
move.l GfxBase,a6 


jsr -246(a6) ‚ Draw () 
movem.| (sp)+,dO-dI1 
rts 


. 
ee. 


. 
Te ee ee 


move.l RastPort,al 
move.l GfxBase,a6 


jsr -342(a6) ‚ SetAPen () 
rts 
OWArgs: ; Windowargumentenliste 
dc.w 0,0 > X,Y Pos. 
dc.w 640,240 ; Breite, Höhe 
dc.b: 1,2 ; Textfarben 
dc. $200 ; IDCMP-Flags: CloseWindow 
dc.! $100b ; WindowTyprFlag 
dc. O ; Kein Gadget 
dc.1 0 ; Kein CheckMark 
dc.l Title ; WindowfTitle 
dc.| O ; Screen 
dc.1 0 ; Bitmap 
dc.w 0,0,640,256 ; Begrenzungen 
dc.w 1 ; Screentyp = WB 
Title: 
dc.b "Sinuskurve berechnet mit der FPU:",O 
even 
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WindowAdresse: 
dc.| 0 ; Variable für Fensteradresse 


IntName: dc.b "intuition.library",O 
even 

IntBase: dc.| O 

GfxName: dc.b "graphics.library",O 
even 

GfxBase: dc.| O 

RastPort: dc.| O 
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1.13 Die MMU-Programmierung 


PMMU steht für Page-Memory-Management-Unit, was soviel 
bedeutet wie Speicherverwaltungseinheit. Die PMMU ist ein 
eigenständiger Co-Prozessor (ähnlich der FPU), dessen Hauptaufgaben 
der Speicher-schutz und die Verwaltung von virtuellem Speicher ist. 
Es gibt sie als externe Version für den MC68010/20 mit der 
Bezeichnung MC68451/851. Die MC68030/40/60-CPUs und deren 
LC-Versionen (nicht EC) haben bereits mindestens eine PMMU 
integriert. Sie verfügen aber nicht über den vollen Funktionsumfang, 
was auch nicht notwendig ist. Sie wurde speziell für bestimmte 
Aufgaben optimiert. Der MC68040 wurde sogar erneut optimiert. 
Doch dazu später mehr. Wir werden hier erst die Programmierung 
der PMMU des M(C68030 und kurz die Unterschiede zur externen 
MC68020-Version (MC68851) beschreiben. Danach folgen die 
Erläuterungen der MC68040-MMUs und deren Unterschiede. 


Wozu eine PMMU im Amiga ? 


Das Amiga-Bestriebssystem unterstützt in seiner jetzigen Form (OS 
3.1) kaum die PMMU. Nur das Programm "FastRom" nutzt sie um 
das Kickstart-ROM in den schnellen Speicher zu verschieben (FAST- 
ROM) und danach die Zugriffe auf die ursprüng-liche (logische) 
Adresse auf die neue (physikalische) umzuleiten, welche sich jetzt auf 
das FAST-RAM beziehen. Damit hätten wir auch schon die 
Hauptaufgabe einer PMMU - die Adreßumsetzung. Die logischen 
Adressen werden über Tabellen in physikalische umgesetzt. Sobald 
die CPU über ihre Adreßleitungen eine bestimmte (logische) Adresse 
ansteuert, die in den Überwachungsraum der PMMU fällt, leitet diese 
die auf die neue (physikalische) Adresse um. Die CPU merkt von 
diesem Vorgang nichts. 
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Wie funktioniert die Adreßumsetzung? 


Die PMMU des MC68030 teilt den gesamten 32-Bit-Speicher in 
Seiten auf. Die Größe einer Seite kann zwischen 256 Bytes und 32 
KByte betragen. Verwaltet werden diese Seiten über Tabellen, ähnlich 
der Menüprogrammierung vom Amiga. Der Vorteil ist eine variable 
Reihenfolge der Seiten (Pages). Damit die Anzahl der Tabellen 
überschaubar bleibt, erfolgt erst eine grobe Speichereinteilung, 
danach wird jede relativ große Seite nochmals in kleinere eingeteilt 
und diese dann noehmals usw.. Der MC68030 kann maximal vier 
Stufen (Ebenen) unterscheiden. Das ganze Gebilde gleicht einem 
Baum (siehe Bild 1.13.a). 


Bild 1.13.a 


=>Start = Zeiger auf Tabellen 
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Der Amiga besitzt mit seinem 32-Bit-Adreßraum eine Größe von 4 
GByte (Adresse $00000000 bis $FFFFFFFF). Jede Ebene kann maximal 
in 2°15 Bereiche eingeteilt werden. Dabei ist darauf zu achten, daß 
die unterste Ebene keinen kleineren Bereich als 256 Bytes bzw. einen 
größeren als 32 KByte hat. Es müssen nicht alle Ebenen genutzt und 
jeder Eintrag bis ins Kleinste eingeteilt werden (Abbruch-Descriptor). 
Nur die EbeneA (Tabelle A, kurz ATab) muß komplett eingeteilt 
werden. Das Ganze ist vergleichbar mit der Programmierung von 
Hauptmenu, Untermenu, Unteruntermenu usw. . 


1.13.1 Die MMU-Register und Befehle 


Die PMMU besitzt einige Register und Befehle, über die sie program- 
miert wird. Als erstes ist das TC-Register (Translation-Control) zu 
nennen. Darüber wird die PMMU aktiviert, die Größe und Anzahl der 
Ebenen eingestellt. 


Belegung des TC-Registers (MC68030): 


Bit Name Funktion 


3] E Enable - Über dieses Bit wird die MMU aktiviert (E= 1) 
30-26 --- unbelegt (Null) 
25 SRE SuperVisor-Enable (SRE= 1, dann wird zwischen SuperVisor- u. User- 


Modus unterschieden. Für SR-Modus wird das SRP- u. für User- 
Modus wird das CRP-Register benutzt) 

24 FCL Function-Code-Lookup (FCL= 1, dann zeigt CRP/SRP nicht auf EbeneA 
sondern auf eine Tabelle mit 8 Einträgen (s. unten) 

23-20 PS3-PSO Page-Size (Diese vier Bits bestimmen die Seitengröße (s. unten) 

19-16 153-ISO Initial-Shift (Anzahl der höchstwertigen Adreßbits, die bei der Ein- 
teilung der Seiten nicht beachtet werden) 

15-12 TIA3-TIAO TableindexA (Anzahl der Einteilungen für Ebene A => 
Anzahl = 2’x (x = O bis 15) 

11-8 TIB3-TIBO TableilndexB (wie TIAx, aber für Ebene B) 

7-4 TIC3-TICO TableindexC (wie TIAx, aber für Ebene C) 

3-0  TID3-TIDO TableindexD (wie TIAx, aber für Ebene D) 
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Beschreibung der FCL-Bits: 

Ist dieses Bit gesetzt, zeigt der CRP auf eine Tabelle mit 8 Einträgen. 
Die einzelnen Einträge weisen dann auf die verschiedenen A-Ebenen 
hin. 


Aufbau der FCL-Tabelle: 


Offset Funktion 

00 reserviert 

04 Zeiger auf Tabelle der Ebene A für USER-Daten 

08 Zeiger auf Tabelle der Ebene A für USER-Programm 

12 reserviert 

16 reserviert 

20 Zeiger auf Tabelle der Ebene A für SuperVisor-Daten 

24 Zeiger auf Tabelle der Ebene A für SuperVisor-Programm 
28 CPU-Speicher (unübersetzt) 

32 Ende der Tabelle 


Beschreibung der PSx-Bits: 


Hier kann die Seitengröße eingestellt werden, die für die unterste 
Ebene von Bedeutung ist. 


PS3 PS2 PS1 PSO__ Seitengröße 


1 0.0 0 256 Bytes 
829793 512 Bytes 
ı 0 1.0 1 KByte 
ı 90 1 1 2 KByte 
ı 12.00 4 KByte 
ı 1.0 1 8 KByte 
ı 1.1.0 16 KByte 
ii: 2073 32 KByte 


Seite 173 


Hardwaregrundlagen Kapitel 1 


Bedeutung der ISx-Bits: 


Diese Bits bestimmen die maximale Größe des logischen Adreß- 
raumes. Bei einem Wert von Null beträgt der logische Adreßraum 
volle 4-GByte. Setzt man die ISx-Bits auf den Wert 0001, wird der 
Adreßraum halbiert (2-GByte), weil das oberste Adreßbit (31) nicht 
zur Adreßumsetzung herangezogen wird. Jede weitere Erhöhung 
bedeutet gleichzeitig eine weitere Halbierung. Der Speicherplatzbe- 
darf der MMU-Tabellen reduziert sich dadurch drastisch. Der Nachteil 
oder auch Vorteil ist, daß der logische Adreßraum sich jetzt mindes- 
tens einmal spiegelt. 


Beispiel für ISx = 0001 (£-GByte Adreßraum) 


logischer Adreßraum hysikalischer Adreßraum 
$0000.0000-$7FFF.FFFF 7 $0000.0000-$7FFF.FFFF 


$8000.0000-$FFFF.FFFFE 2 $0000.0000-$7FFF.FFFF 


Wie man an dem Beispiel erkennt, wird bei einem Zugriff auf die 
Iogische Adresse $8000.0000 auf die physikalische Adresse $0000. 
0000 zugegriffen. 


Bedeutung der Tableindex-Bits: 


Diese vier Blöcke bestimmen für jede Ebene die Anzahl der 
Tabelleneinträge. Ist einer der Blöcke Null, so werden die nach- 
folgenden ignoriert und man braucht dafür keine Tabellen mehr 
anlegen. Die Anzahl der Tabelleneinträge pro Ebene errechnet sich 
nach folgender Formel: 


Anzahl = 2x (x=Wert für Tableindex eines Blocks) 
Zum Beispiel errechnen sich die Anzahl der Tabelleneinträge für 


einen 4-GByte Adreßraum (ISx=0000) und einer Seitengröße von 4- 
KByte (PSx=0000) wie folgt: 
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TIAx = 0100 = 4 = 2°4 = 16 Tabelleneinträge für Ebene A 
TIBx = 1000 = 8 = 2°8 = 256 Tabelleneinträge für Ebene B 
TI& = 1001 = 5 = 2°5 = 32 Tabelleneinträge für Ebene C 
TIDx = 0011 = 3 = 2°3 = 8 Tabelleneinträge für Ebene D 


Anzahl der gesamten Einträge: 
16 x 256 x 32x8 = 1.048.576 Einträge 


Die Werte müssen multipliziert werden, da jeder Eintrag aus Tabelle 
A auf eine Tabelle der Ebene B mit jeweils 256 Einträgen zeigt. Jeder 
Eintrag aus Tabelle B zeigt auf eine Tabelle der Ebene C von jeweils 
32 Einträgen usw.. Bei einem Kurzformat von 4 Bytes pro Eintrag 
würde die Tabelle 4-MByte Speicher benötigen (1.048.576 x 4 / 
1024). Dieser Platzbedarf wäre natürlich viel zu groß. Deswegen gibt 
es die Möglichkeit, sogenannte Early-Termination-Descriptoren einzu- 
bauen (s. unten). 


Wichtig für den TC-Wert ist, daß die Summe aus den letzten 6 
Blöcken 32 ergibt. Ansonsten wird gleich, bei Aktivierung der MMU, 
eine Exception ausgelöst (Vektor-Nr. 56). 


Becingungen für das TC-Register: 


1) PSx + ISx + TIAx + TIBx + TICx + TIDx = 32 

2) PSx zwischen 8 und 15 

3) ISx zwischen O und 15 

4) TIAx zwischen 2 und 15 

5) TIBx zwischen O und 15 

6) TICx zwischen O und 15 ; keine Funktion, wenn TIBx =0000 

7) TIDx zwischen O und 15 ; keine Funkt., wenn TIBx o. TICx =0000 


Für unser obiges Beispiel sind die Bedingungen erfüllt. 


32 
32 


1) PSx + ISx + TIAx + TIBx + TI&x + TIDx 
12 +0 +4 +8 +5 +3 
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Die Größe jeden Adreßraumes errechnet sich wie folgt: 


Adr m ___ Formel für obi ispiel 

Gesamt G=4GByte/2"Iıx  G=4GByte/2”0 = 4GByte 

Tabelle A A=G/2"TIAx A=4GByte/2”4 = 16 Einträge a 256 MByte 
Tabelle B B=A/2"TIBx B=256MByte/2”8 = 256 Einträge a 1 MByte 
Tabelle C C=B/2”TICx C= 1MByte/2°5 = 32 Einträge a 32 KByte 
Tabelle D D=QU2’TIDx=PSx D=32KByte/2”3=PSx= 4 KByte pro Seite 


Das CRP/SRP-Register 


Wir wissen jetzt, wie die PMMU konfiguriert wird, aber woher 
bekommt sie die Informationen, ab welcher Adresse die Tabelle A 
beginnt. Dafür exestieren die 64-Bit-Rootpointer CRP (für USER- 
Modus) und SRP (für SuperVisor-Modus). Der Aufbau ist für beide 


Register identisch. 


Belegung ces CRPISRP-Registers 


Bit Name 
63 LU 


62-48 Grenze 


47:34 u 
33-32 DT1-DTO 


31-4  PAddress 


Funkti 

Lower/Upper (legt fest ob "Grenze", die obere (LU=O) o. die 
untere (LU= 1) Anzahl der Einträge beschreibt (0=Normal) 
maximale bzw. minimale Anzahl Einträge oder Null (Normal) 
unbelegt (Null) 

Descriptor-Typ (Beschreibt das Format für alle Einträge der 
MMU-Tabellen) 

10 = Kurzformat (Jeder Eintrag hat 4 Bytes) 

11 = Langformat (Jeder Eintrag hat 8 Bytes) 

physikalische Adresse der Tabelle A. Die letzten vier Bits (3-0) 
müssen immer Null sein. Also muß die Anfangsadresse der 
Tabelle A glatt durch 16 teilbar sein. Das gilt auch für die 
anderen Ebenen. 

unbelegt (Null) 
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Aufbau eines Tabelleneintr . 


Jeder Tabelleneintrag kann entweder kurz (4 Bytes) oder lang (8 
Bytes) sein. Festgelegt wird das Format im Rootpointer (s. oben) für 
alle Einträge einheitlich. Das Langformat wird eigentlich kaum 
benutzt, weil der Speicherbedarf für die Tabellen doppelt so hoch 
wäre. Die PMMUs des MC68040 unterstützen nur noch das 
Kurzformat. 


Es werden fünf Descriptoren (Beschreibungen) bereitgestellt (jeweils 
für das Kurz- und Langformat). 


- Tabellen (Zeiger auf eine Tabelle der nächsten Ebene) 
- Page (Zeiger auf eine Seite der PSx-Größe) 

- ungültiger (Null-Eintrag, führt zu einer Exception) 

- indirekt (Zeigt auf einen weiteren Seiten-Descriptor) 


- früher Abbruch (Early-Termination: Zeiger auf Seite die größer 
als PSx ist => keine Tabellen mehr erfoderlich) 


Die 4- Descriptoren (Kurzformate): 


1) kurzer Tabellen-Descriptor 


(Zeiger auf Tabelle der nächsten Ebene) 


Bits: ae Sera wer = EN 
Tabellenadresse U WP 1 0 


Beispiel: dc.! A0UTabPtrBO+$02 ; $02 für Tabellenkennung 10 


Die Tabellenadresse muß glatt durch 16 teilbar sein. Bedeutung der 
restlichen Bits folgt unten. 
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2) kurzer Seiten-oder Abbruch-Descriptor 


Bits: 3. ARE ERITREERN 8 7 6543 2 ER 
Seitenadresse 0 CIOMUWPO1 


Beispiel: dc.!l DOPtrPage0+$01 ; $01 für Seitenkennung O1 


Die Seitenadresse muß glatt durch 256 teilbar sein. Das ist auch der 
Grund, warum die kleinste Seitengröße 256 Bytes beträgt. Ein Seiten- 
descriptor steht immer in der letzten Ebene und zeigt auf die Seite 
der PSx-Größe. Befindet sich ein solcher Descriptor nicht in der 
letzten Ebene, so wird er als Abbruchdescriptor bezeichnet und die 
Seitengröße entspricht der Tablelndex-Ebene. Für unser Beispiel 
TIBx= 1000, würde ein Abbruchdescriptor-Eintrag in der Ebene B auf 
eine Seite der Größe von 1 MByte zeigen. Alle anderen Einträge der 
Ebene B können weiterhin auf Tabellen der Ebene C zeigen und 
jeweils 1 MbByte-Adreßraum nochmals wie oben beschrieben 
unterteilen. Durch die Abbruchdescriptoren verringert sich der 
Speicherplatz für den MMU-Baum drastisch. 


3) kurzer ungültiger Descriptor 


(Null-Eintrag => führt zu einer Exception) 


unbelegt (Null) 


Beispiel: dc.lO 
Ein ungültiger Descriptor kann an jeder beliebigen Stelle einer Ebene 


stehen und führt zum Abbruch des Tabellensuchvorgangs. Alle 
Zugriffe auf die dazugehörige Seitenadresse führen zu einer Exception 
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(BUS-Fehler). Durch diese Descriptoren kann ein entsprechendes 
Programm virtuellen Speicher verwalten. 


4) kuzer indirekter Descriptor 


(Zeiger auf einen weiteren Seiten-Descriptor) 


Seitendescriptoradresse 1 0 


Beispiel; dc.| PageDescriptor+$02 ; $02 für Kennzeichnung 
PageDescriptor: dc.| DOPtrPageO + $01 


Der Aufbau ist ähnlich eines Tabellen-Descriptors. Diesen findet man 
in der letzten Ebene an Stelle eines Seiten-Descriptors und zeigt auf 
einen evtl. schon vorhandenen Seiten-Descriptor. So können Seiten- 
Descriptoren mehrmals benutzt werden. Wir in der der Praxis kaum 
eingesetzt. Die Adresse muß auch hier glatt durch vier teilbar sein. 


Beschreibungen der its im ipt 

Na tu 

WP Write-Protect (Mit diesem Bit kann man Seiten vor einem 
Schreibzugriff sichern => WP=1) 

U Used (Sobald auf die zu diesem Descriptor gehörende 


Seite zugegriffen wird, geht dieses Bit auf 1 und kann nur 
vom Programm wieder gelöscht werden) 

M Modified (Sobald auf die dazugehörige Seite ein Speicher- 
zugriff erfolgt, wird dieses Bit gesetzt und kann auch nur 
vom Programm wieder gelöscht werden) 

Cı Cache-Inhibit (Ist dieses Bit gesetzt werden die Daten bzw. 
Befehle nicht in den dazugehörigen Cache geschrieben) 
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5 


Grenze 


LU 


SuperVisor (Setzt man dieses Bit, kann nur im SuperVisor- 
Mode auf diese Tabelle zugegriffen werden) 

Funktion entspricht der von CRP/SRP. Die Grenze ist Ab- 
hängig vom LU-Bit. Ist dieses gesetzt, muß die Anzahl 
Tabelleneinträge größer oder gleich dem Grenzwert sein. 
Ist es gelöscht, muß die Anzahl Tabelleneinträge gleich 
oder kleiner dem Grenzwert sein. 

Lower/Upper (Funktion siehe CRP/SRP-Register) 


Die 8-Byte-Descriptoren (Langforma 


Die 8-Byte-Descriptoren bestehen aus zwei Longwords. Das erste (LW) 
besitzt eine spezielle Kennung und einen Grenzwert. Das zweite (L\W) 
in der Regel die Tabellen- oder Seitenadresse. 


1) langer Tabellendescriptor 


(Zeiger auf Tabelle der nächsten Ebene) 


Bits: 
1.LW 


Bits: 
2.LW 


Beispiel: 


TS 2 E 08 


31 39..316 15..10 9 8 
0S dB U WwEiIi1l 


LU Grenze 1 


Tabellenadresse unbelegt 


dc.| $OO00FCO3,AOTabPtrBO ; $03 1.LW für Kennung 


Im ersten Longword kann die Grenze der Tabelleneinträge für die 
Tabelle auf die im 2. Londword die Tabellenadresse zeigt einstellen. 
Die Tabellenadresse muß glatt durch 16 teilbar sein. 
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2) la iten- od ch- iptor 

Bits: 31 238..1418 25. 32 8 7:3 Z.0% 

1.LW LU Grenze 1 0S O0 UWPOL1l 

Bits: ee ee ae 0 

2.LW Seitenadresse unbelegt 

Beispiel: dc.| $OOOOFCO1,DOPtrPageO ; $01 1.LW für Kennung 


Das erste Longword entspricht in seiner Funktion als Abbruch- 
Descriptor der eines Tabellen-Descriptor. Für den Seiten-Descriptor 
sind die Grenze und das LU-Bit unbelegt. Die Funktion des 
Descriptors ist die gleiche wie die des kurzen Descriptortyps. 


(Null-Eintrag => führt zu einer Exception) 
beide Longwords sind Null 
Beispiel: dc.| 0,0 
Die Funktion ist die gleiche wie beim kurzen ungültigen Descriptor. 


4) la indir iptor 
(Zeiger auf einen weiteren Seitendescriptor) 
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Bits: SER TER EIR Een a Re 0 
2.LW Seitendescriptoradresse unbelegt 
Beispiel: dc.| 3,PageDescriptor 


PageDescriptor: dc.| $OO0OFCO1,DOPtrPageO 


Die Funktion enspricht der eines kurzen indirekten Descriptors. Die 
Adresse muß glatt durch vier teilbar sein. 


Die Register TIO und TT1 (Transparent-Translation) 


Seit dem MC68030 können Adreßbereiche (Fenster) definiert werden, 
in denen keine Adreßumsetzung über die MMU statt findet. Die 
logische Adressse entspricht dann der physikalischen. Ein Fenster 
kann eine Größe zwischen 16-MByte und 2-GByte haben. Bei 
Zugriffen, die in den Fensterbereich fallen, wird der ATC (Adreß- 
Translation-Cache) nicht beachtet. Der MC68030 besitzt zwei Fenster 
mit den Bezeichnungen TTO und TT1. 


Belegung der TTx-Register (Transparent-Translation) 


Bit Name Funktion 

31-24 Fensteradr. Diese 8-Bits werden mit der logischen Adresse (Bits 
24 bis 31) verglichen. Bei Übereinstimmung wird nicht 
durch die MMU übersetzt. 

23-16 FensterMaske Maske für den Vergleich der logischen Adresse mit der 
Fensteradresse. Jedes gesetzte Bit wird beim Vergleich 
ignoriert. 


15 E Enable (Ist dieses Bit gesetzt, wird der Fensterbereich 
aktiviert; bei Null hat das Fenster keine Auswirkung. 

14-11 nicht belegt (Null) 

10 « Cache-Inhibit (wenn CI=1, werden keine Speicherbe- 


reiche innerhalb des Fensters in den Daten- o. Befehls- 
Cache übernommen. 
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9 R/W Fensterbereich nur für Schreib- (R/W=0) oder nur für 
Lesezugriffe (R/W=1) nicht von der MMU übersetzen 
lassen. 

8 RWM RWM=1, dann wird das R/W-Bit benutzt. 


RWM=0, keine Funktion des R/W-Bits. Fensterbereich 
wird für Schreib- und Lesezugriffe genutzt. 


A nicht belegt (Null) 
6-4 FC-Mode Function-Code-Kombination, die für den Fensterbereich 
erlaubt ist. 


001 =USER-Datenzugriff; 010=USER-Befehlszugriff 
101 =SR-Datenzugriff; 110=SR-Befehlszugriff 
111=CPU-Speicher 

Immun nicht belegt (Null) 

2-0 FC-Maske FC-Mode-Bits können hierüber ausmaskiert werden und 
haben dann keine Funktion mehr. 


Das Adreßü tzu che (AT 


Auch die PMMU hat einen eigenen Cache, den sogenannten Address- 
Translation-Cache (ATC). Er kann maximal 22 Einträge mit 2 x 28 Bit 
jeweils für logische und physikalische Descriptoren (Tabelleneinträge) 
aufnehmen. Im Gegensatz zum CPU-Cache kann mit dem PMMU- 
Befehl "PLoad" direkt auf den ATC zugegriffen werden. Erst wenn 
kein passender Eintrag gefunden wird, durchsucht die PMMU die 
Tabelleneinträge. Das hat den Vorteil, daß bei einem passendem 
Eintrag (log. Adresse) im ATC sofort die physikalische Adresse bereit 
steht. Anderfalls müssen erst alle Tabellen durchsucht werden. 


Aufbau vom ATC (MC68030: 2 x 28-Bit) 


Bits: ET BR, ern un er Pe 0 
(28-Bit) V Function-Code logische Adresse 


Bits: EEE ar Eee ER a 0 
(28-Bit) B CI WP M physikalische Adresse 
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Beoeutung der Bits, die noch micht erklärt wurden: 


Eintrag gültig (V=1) oder ungültig (V=0) 
BUS-Fehler (B=1) => tritt auf, wenn dieser Eintrag aus den 
ATC gelesen wird. 


< 
Nu 


Das Statusregister der MMU (MMUSR) 


Vergleichen kann man dieses Register mit dem CPU-Statusregister. 
Über die MMU-Befehle "PTestW" und "PTestR" können Schreib- und 
Lesezugriffe auf die Adreßumsetzung der PMMU getestet werden. 
Entsprechend werden dann die Bits vom MMUSR gesetzt. Man 
unterscheidet zwei Zugriffsarten. Entweder befindet sich der passende 
Eintrag zur logischen Adresse im ATC (A) oder noch in einer Tabelle 


(B). 
Belegung des MMUSR (MC68030) 


Bits: ı5 12 13 42 11 10 
I 


8 
BL SO M 0 


oO u 
oO »$ 
oO W 
DD 
Pr 
oO 


9 76 
M DB: 


BUS-Fehler (B) 

A: Dieses Bit wird gesetzt, wenn das Bit im ATC-Eintrag "1" ist. 

B: Wird gesetzt wenn während der Suche in den Tabellen ein BUS- 
Fehler aufgetreten ist. 


Grenzüberschreitung (L) 
f&: L=0 
B: L=7 
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SuperVisor_($) 

A: 5=0 

B: wird gesetzt, wenn der SuperVisor-Eintrag im USER-Modus be- 
nutzt wurde. 


Schreibschutz (W) 
AB: Ist im Eintrag das WP-Bit gesetzt, so wird auch W=1. "W" ist un- 
definiert, wenn das I-Bit = 1 ist (s. unten). 


ungültiger Eintrag (I) 
AB:Sobald ein Eintrag ungültig oder das B- bzw. L-Bit gesetzt ist, 
wird I=1. 


Modify_(M) 
AB: Wurde die Seite zum Eintrag verändert (modifiziert), ist M=1. 
"M" ist undefiniert, wenn das "I"-Bit = 1 ist. 


Fensterbereich (T) 

A: Das Bit wird gesetzt, wenn der ATC-Eintrag in den Fensterbereich 
fällt (TTx). Wenn T=1, dann sind alle anderen Bits ungültig. 

B: T=0O 


Tabellenebene (Nx) 
A: Nx=000 
B: Nummer der Ebene, in der der Eintrag gefunden wurde. 


Jetzt haben wir alle Register der PMMU des MC68030 beschrieben. 
Bevor wird auf die Unterschiede zur MC68040-MMU eingehen, 
beschreiben wir noch den Weg zu einer korekten Initialisierung der 
PMMU. 
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Initialisierung einer PMMU in der Übersicht 


1) TC-Register löschen (evtl. alten Wert retten), damit wird die 
PMMU deaktiviert (E=0) 

2) Parameter wie Seitengröße, Anzahl der Ebenen, Modus, Format 
usw. festlegen (aber noch nicht in das TC-Register schreiben). 

3) CRP/SRP-Register initialisieren oder Tabelle mit 8-Einträgen 

4) MMU-Tabellen (Anzahl und Größe) berechnen und anlegen 

5) Fensterbereiche anlegen oder Null für keine in die TTx-Register 

6) TC-Register mit korektem Wert beschreiben (MMU = aktiv) 


Die PMMU des MC68040/1LC040 


Die PMMU des MC68040 ist noch einfacher aufgebaut als die vom 
Vorgänger. Sie kennt jetzt nur noch eine feste Anzahl von Ebenen 
und die Seitengröße beträgt nur noch 4 bzw. 8 KByte. Die Register 
und Descriptoren sind nicht mehr kompatibel zur MC68030-MMU. 
Deswegen muß beginnend vom Grundaufbau alles neu initialisiert 
werden. | 


Unterschiede der PMMUs (MC68030 zur MC68040) 


Funktion MC68030 MC68040 
Seitengröße der letzten Ebene 256 Byte bis 32 KByte 4 oder 8 KByte 
Anzahl MMUs eine für Daten u. Befehle 2 getrennte MMUs 
Anzahl der Ebenen 1 bis 4 immer 3 

Anzahl TTx-Register zwei vier 

Breite der CRP/SRP-Register 64-Bit 32-Bit 
Tabellenformat kurz oder lang nur kurz 

Grenze für Anzahl Tabellen ja nein 

Breite des MMUSR 16-Bit 32-Bit 

Anzahl der ATC-/TLB-Einträge 22 64 


Alle Register der MMU sind jetzt 32-Bit breit. 
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Für den MC68040 sind in diesem Register nur noch die Bits 15 und 
14 belegt (E, PS). Denn die Anzahl der Ebenen ist fest auf 3 
eingestellt. Die Ebenen 1 und 2 enthalten immer 128 Einträge und 
Ebene 3 entweder 32 (bei 8-KByte Seiten) oder 64 (bei 4-KByte 
Seiten). 


Belegu TC-Register (nur 16-Bit 


Bit_Name_ Funktion 

15 E _ Enable -PMMuUs aktivieren [E= 1] oder deaktivieren [E=0] 
14 P Größe der Seite der letzten Ebene (0=4 KB,1=8 KB) 
13-0 --- nicht belegt (Null) 


Damit ergeben sich feste Adreßbereiche für die einzelnen Ebenen: 


Ebene A = 128 Einträge a 32 MByte (4 GByte / 128) 
Ebene B = 128 Einträge a 256 KByte (32 MByte / 128) 
Ebene C = 32 Einträge a 8 KByte für P=1 (256 KByte / 32) 
Ebene C = 64 Einträge a 4 KByte für P=O (256 KByte / 64) 


Das URP/SRP-Register (Rootpointer) 


Die Bezeichnung für die Rootpointer haben sich in URP (User- 
Rootpointer) und SRP (SR-Rootpointer) geändert. Es können zwei 
MMU-Bäume angelegt werden (User/SuperVisor). Sinnvoller ist es 
aber, beide auf die gleiche Adresse zeigen zu lassen (Ebene A). Die 
Breite beträgt für beide Pointer auch nur noch 32 Bit. Es gibt auch 
keine Begrenzung der Einträge mehr. Die Bits O bis 8 sind unbelegt 
(Null). Deswegen muß die Adresse der Tabelle A glatt durch 512 
teilbar sein, 
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Aufbau des URP/SRP-Register 


Adresse der Tabelle A unbelegt (Null) 


Aufbau eines Tabelleneintrages (MC68040) 


Alle Tabelleneinträge für die MC68040-MMU sind einheitlich 4-Bytes 
lang (Kurzformat). Folgende Descriptoren unterscheidet man: 


- Tabellen 
- Page 

- ungültige 
- indirekte 


Zeiger auf eine Tabelle der nächsten Ebene) 
Zeiger auf eine Seite der PS-Größe) 
Non-resident) 

Zeiger auf weiteren Seiten-Descriptor) 


mu un u es, 


1) kurzer Tabellen-Descriptor 


(Zeiger auf Tabelle der nächsten Ebene) 


Bits: Sic aa Bu 3 Basar, #3 2 1,0 
Tabellenadresse unbelegt U W UDT 


Beispiel: dc.| A0UTabPtrBO + $02 


Die Funktion entspricht der eines hurzen Tabellen-Descriptors vom 
MC68030. Für die Ebene A muß die Adresse ohne Rest durch 512 
und für Ebene B durch 256 (bei 8-KByte-Seiten) bzw. durch 128 (bei 
4-KByte-Seiten) teilbar sein. Die Bits O und 1 (UDT) enthalten die 
Kenn-zeichnung für einen Tabellendescriptor. Gültige Werte sind 2 
(UDT = 10) oder 3 (UDT= 11). Auf die Funktion der anderen Bits sind 
wir ja schon eingegangen. 
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2) kurzer Seiten-Descriptor 


— 


Bits: ee 123 12 33 38 3:8 7 8.:5 8 32 9 
Seitenadressee R R G VUO/U1 S CM MUWOL 


Die Funktion entspricht der eines kuzen Seitendescriptors vom 
MC68030. Für 4-KByte-Seiten muß die Adresse glatt durch 4096 und 
für 8-KByte-Seiten glatt durch 8192 teilbar sein. Für 4-KByte-Seiten 
wird Bit 12 noch zur Seitenadresse herangezogen. 


3) kurzer ülti iptor 
Bits: en 0 


unbelegt (Null) 


Beispiel: dc.| O 

Funktion siehe kurzer ungültiger Descriptor für MC68030. 

4) kurzer indirekter iptor 

(Zeiger auf einen weiteren Seitendescriptor) 

Aufbau und Funktion, wie beim MC68030. 

Beispiel: dc.| PageDescriptor+$02 ; $02 für Kennzeichnung 


PageDescriptor: dc.| DOPtrPageO + $01 
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Beschreibungen der Status-Bits im Descriptor 


Bit Bedeutung 
R reserviert für Anwender 
G Global - Di Einträge mit G= 1 werden nicht durch den 


Befehl "PFlush" gelöscht 

UO/U Fü Anwender. Bei einem BUS-Zyklus erscheint die Kombi- 

nation auf den Leitungen UPAO und UPA1. 

5 SuperVisor - Zugriff nur im SR-Modus erlaubt. 
CM CacheMode - Cache-Modus definieren 
00=Cacheable, Write Trough 
01 =Cacheable, CopyBack 
10=Cache Inhibited, serialized 
11=Cache Inhibited non serialized 
WriteProtect - Eintrag ist Schreibgeschützt 
Modified - siehe MC68030 
Used - Siehe MC68030 


esz 


Die Register ITT0/1 und DTT0/1 (Transparent-Translation) 


Im Gegensatz zum MC68030 hat die MMU des MC68040 vier 
Transparent-Translation-Register. Jeweils zwei für Daten (DTTO/1) und 
Befehle (ITT0/1). Die Fenster arbeiten unabhängig vom TC-Register 
(Enable-Bit). 


Der Adreßübersetzungs-Cache (TLB) 
Jeder Eintrag der Ebene B zeigt bei einer 4-KByte-Seite auf eine 
Tabelle von max. 64-Einträgen. Bedingt dadurch wurde der Adrel- 


übersetzungs-Cache auf 64 Einträge erhöht und die Bezeichnung in 
Translation-Lookaside-Buffer (TLB) geändert. 
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D ister vom MC MUSR 


Das Status-Register der MC68040-MMU wurde komplett geändert 
und ist jetzt 32-Bit breit. Die Breite ist notwendig um zwischen 
Daten- und Befehlseinträgen zu unterscheiden. Die physikalische 
Adresse des betroffenen Eintrages wird jetzt im MMUSR eingetragen 
(Bits 31 bis 12). Ein Bus-Fehler wird durch Bit 11 signalisert. Das 
Global-Bit spiegelt sich auf Bit 10 und die User-Attribut-Bits sitzen auf 
Bit 9 und 8. Den Cache-Modus können Sie den Bits 6 und 5 
entnehmen. Die Fensterberührung (T) kann über Bit 1 ermittelt 
werden. Die Bits S, W und M befinden sich auch im MMUSR, aber 
auf anderen Positionen. 


Die MMU-Befehle 


Wie die FPU besitzt auch die MMU Befehle über die sie pro- 
grammiert wird. Die externe MC68851-MMU beinhaltet die meisten 
Befehle. Bei allen nachfolgenden Versionen wurde der Befehlssatz 
radikal reduziert. 


Funktion ABC 
PBcc Label Wie Bcc (aber MMUSR statt CCR) x 
PDBcc Dn,Label Wie DBcc (aber MMUSR statt CCR) x 
PFlush (An) Eintrag im TLB löschen x 
PFlush <fc> ‚#maske Löscht nur die ATC-Einträge mit einem 

bestimmten Modus (Function-Code) X 
PFlush <fc> ‚#maske, <ea> Löscht nur die ATC-Einträge mit 

einem bestimmten Modus und einer 

logischen Adresse. X 
PFlushA Alle Einträge im ATC löschen XXX 
PFlushAN Alle Einträge im TLB löschen X 
PFlushN (An) löscht alle TLB-Einträge auf die sich 

die logische Adresse An bezieht X 
PFlushR <ea> Rootpointer-Eintrag im ATC löschen X 
PFlushS <fc> ‚#maske Entfernt alle ATC-Einträge mit be- 

stimmten Function-Code X 
PloadR <fc>,<ea> Lade einen Eintrag in den ATC (U=1) X X 
PLoad\W <fc>,<ea> Lade Eintrag in den ATC (U=1,M=1) X X 
PMove <ea>,MRn Daten in ein MMU-Register schreiben X X 
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PMove MRn,<ea> Daten aus ein MMU-Register lesen X 
PMoverFD <ea>,MRn wie PMove und ATC löschen X 
PRestore <ea> PMMU zurücksetzen x 
PSave <ea> PMMU-Zustand sichern X 
PScc <ea> Wie Scc (aber MMUSR statt CCR) x 
PTest (An) Teste Tabelle und ATC -> Ergebnis 

steht im MMUSR x 
PTestR <fc>,<ea> ‚#ebene Lesezugriff bis Ebene X und be- 

stimmten Function-Code simulieren. 

Ergebnis steht im MMUSR “X 
PTest\W <fc>,<ea> ‚#ebene Schreibzugriff bis Ebene X und be- 

stimmten Function-Code simulieren. 

Ergebnis steht im MMUSR X 
PTrapcc wie Trapcc (aber MMUSR statt CCR) x 
PTrapcc #x wie Trapcc (aber MMUSR statt CCR) x 
PValid An,<ea> Andern der Zugriffsebene X 
PValid VAL,<ea> Andern der Zugriffsebene X 
<ea> = effektive Adresse 
<fc> = Modus (Function-Code: O bis 7) 
#ebene = Ebene der Tabelle (1 bis 4, O=ATC) 
#maske = Maske für Modus (0 bis 7) 
#x = Trapnummer 
An = Adreßregister O bis 7 
Dn = Datenregister O bis 7 
MRn = MMU-Register (TC, MMUSR,DTTO,DTT1,ITTO,ITT1,TTO,TT1,CRP,SRP) 


Die Register der MC68030-MMU können mit dem Befehl "PMove" 
modifiziert werden. Für die MC68040-MMU muß man den priveli- 
gierten Befehl "MoveC" einsetzen. 
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1.13.2 MMU-Beispielprogramm 


Einige von Ihnen kennen sicher das Programm "FASTROM". Wenn 
Sie Besitzer von 32-Bit-FastRAM sind, können Sie mit dem Programm 
das Kickstart-ROM in den schnellen Speicher verschieben. Über die 
MMU werden dann die Zugriffe auf den logischen Adreßraum von 
$00OF80000 bis $OOFFFFFF (512 KByte) auf die physikalischen im 32- 
Bit-FastRAM umgeleitet. Der physikalische Adreßraum ist natürlich 
schreibgeschützt (WP=1). Das Beispielprogramm läuft unter einem 
MC68030 mit MMU. Es ist leicht auf die MC68040-MMU erweiter- 
bar. Dazu wurden 8-KByte-Seiten (PSx=1101) und je 128 Ein-träge 
für Ebene A (TIAx=0111) und B (TIBx=0111) gewählt, wie sie für 
den MC68040 typisch sind. Alle nötigen Werte können Sie der 
nachfolgenden Tabelle entnehmen. Wird das Programm ein zweites 
mal aufgerufen, wird FASTROM wieder deaktiviert (MMU = aus). 


Werte für Beispiellisting "FASTROM": 
Rootpointer (URP): Zeigt auf Tabelle A; für alle Einträge Kurzformat 


TC-Register = $80D07750 


PSx = 1101 = 13 => 8-KByte-Seiten 

ISx = 0000 = 0 => volle 4-GByte-Adreßraum 

TIAx = 0l1ll = 7 => 128 Einträge a 32 MByte (4GByte/128) 
TIBx = 0lll = 7 => 128 Einträge a 256 KByte (32MByte/128) 
TICK = 1001 = 5 => 32 Einträge a 8 KByte (256KByte/32) 
TIDx = 0000 = 0 => nicht vorhanden 


Bedingung: PSx+ISx+TIAx+TIBx+TICx+TIDx=13+0+7+7+5+0=32 


Mit folgender Formel errechnet man die Nummer eines Eintrages der Ebene X" 


Nummer = Zieladresse/Größe pro Eintrag 
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Für unser Beispiel mit obigen Werten und der Zieladresse $F80000 
(ROM) errechnen sich folgende Werte: 


$OOF80000 / 02000000 
$OOF80000 / 00040000 


O für Ebene A 
62 für Ebene B 


Für das Programm ist der Offset wichtiger als die Nummer. Für das 
Kurzformat muß die Nummer noch mit vier multipliziert werden. 


Offset für Ebene A 
Offset für Ebene B 


Nummer x 4 
Nummer x 4 


OX4=OD 
Bx4=2 


48 


Für unser Beispiel ergeben sich insgesamt 256 Einträge, je 128 für 
Ebene A und B. Wir verwenden auch nur Abbruch-Descriptoren. Die 
Einteilung der Tabellen entnehmen Sie bitte Bild 1.13.2.a. Zusätzlich 
zum Tabellenpuffer reserviert das Programm noch 512 weitere Bytes. 
Hier werden einige Informationen für das Togglen gespeichert. 


Möchten Sie andere MMU-Programme programmieren, benötigen Sie 
immer bestimmte Schrittweiten die sich aus dem TC-Wert ergeben. 
Damit Sie nicht immer umständlich rumrechnen müssen, können Sie 
folgender Tabelle die Hexwerte zu bestimmten Schrittweiten ent- 
nehmen. 


Hex Schrittweite Hex Schrittweite 
$00000001 1 Byte $00010000 64 KByte 
$00000002 2 Bytes 00020000 128 KByte 
$00000004 4 Bytes $00040000 256 KByte 
$00000008 8 Bytes $00080000 512 KByte 
$00000010 16 Bytes $00100000 1 MByte 
$00000020 32 Bytes 00200000 2 MByte 
$00000040 64 Bytes $00400000 4 MByte 
$00000080 128 Bytes 500800000 8 MByte 
$00000100 256 Bytes $01000000 16 MByte 
H00000200 512 Bytes $02000000 32 MByte 
$00000400 1 KByte 504000000 64 MByte 
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$00000800 2 KByte $08000000 128 MByte 
$00001000 4 KByte $10000000 256 MByte 
$00002000 8 KByte $20000000 512 MByte 
$00004000 16 KByte $40000000 1 GByte 
$00008000 32 KByte $80000000 2 GByte 
Bild 1.13.2.a 


Jeder Eintrag deckt 32 MByte 
(Schrittweite = $82888888) 


eder Eintrag deckt 256 KByt 
daearıkeusıea = 588848088) 
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TableSize = (128*2*4)+512 ; Länge der Tabellen 
move.|l 4,36 
move.w 296(a6),dO ‚ Attn-Flags 
btst #2,dO ; min. MC68030-Prozessor 
beq NO MMU ; könnte evtl. auch EC sein 
move.|l 4,a6 
jsr -132(a6) ; Forbid Multitasking 
jsr -150(a6) ;‚ SuperState 
move.| dO,OIdSP 
pmove.| TC,OIdTC ; alten TC retten 
pmove.| CIrTC,TC ; TC löschen (MMU = aus) 
pmove.q crp,OldCRP ; alten CRP retten 
move.| 4,36 
move.| OldSP,dO 
jsr -156(a6) ; UserState () 
jsr -138(a6) ; Permit () 
move.| OIdTC,dO ; TC nach DO 


cmp.!l #%80d07750,d0; TC für FastROM ? 

bne MMU ON 

move.| OIdCRP+4,a0 ; TabellenA-Adresse 

lea 1024(a0),‚a0 ; InfoAdresse für FASTROM 
cmp.! #"FAST",(aA0) ; Kennung vorhanden ? 
bne MMU ON 

cmp.| #"V1.0",4(a0) ; Version korekt ? 

bne MMU ON 
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;--- FastROM wieder deaktivieren --- 


move.| 8(a0),al ; ROMAdresse 
move.|l #$80000,40 ; Länge = 512 KByte 
move.| 4,a6 

move.| a0,-(sp) 

jsr -210(a6) ; FreeMem () 

move.| (sp)+ a0 


move.| 12(a0),al ; Tabellenadresse 
move.| #TableSize,‚dO ; Länge 

move.| 4,a6 

moveq #0,d1 

move.| d1,(a0) ; Kennung für 
move.| d1,4(a0) ‚ FastROM löschen 
jsr -210(a6) ; FreeMem () 


lea TextMMUOFf,aO 

bsr PrintText 

moveq #0,d0 

rts ; Programmende 


-- FastROM aktivieren --- 


MMU ON: 
move.| OIdTC,dO 
btst #31,d0 ; MMU in use ? 
bne MMUlnUse 


move.| #80000,d0 ; Länge = 512 KByte 
move.|l dO,d1 ;‚ Teiler = 512 KByte 
bsr AllocTeilerMEM 

move.|l dO,ROMAdr 

beq Error 
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move.| #TableSize,dO ; Länge der Tabellen 
move.| #512,d1 ;‚ Teiler = 512 

bsr AllocTeilerMEM 

move.| dO,NewCRP +4 

beq Error 


move.| #($80000/16)-1,dO 
lea.| $F80000,a0 
move.| ROMAdr,a! 


ROMLoop: 
move.| (a0)+,(al)+  ; ROM kopieren 
move.| (a0)+ ,(al)+ 
move.| (a0)+ ‚(al)+ 
move.| (a0)+ ‚(al)+ 


dbra dO,ROMLoop 


bsr InittMMUTable ; MMU-Baum erzeugen 


move.| 4,36 
jsr -132(a6) ; Forbid () 
jsr -150(a6) ; SuperState () 


move.| dO,OIdSP 


pflusha ‚ alle Einträge im ATC löschen 
pmove.q NewCRP,CRP ; Tabellenanfang setzen 
pmove.| NewTC,TC ‚ TC setzen (MMU = ein) 


move.|l 4,36 

move.l OldSP,dO 

jsr -156(a6) ; UserState () 
jsr -138(a6) ; Permit () 


lea TextMMUON, a0 

bsr PrintText 

moveq #0,d0 

rts ; Programmende 
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;-- MMU-Tabellen anlegen ---- 


InitMMUTable: 


moveq #1,d0 ; Start TableA (1 = Seitendesc.) 
move.| #$2000000,d1 ; Schrittweite = 32 MByte 
moveq #127,d2 ; 128 Einträge 


move.| NewCRP+4,30 ; Adresse TableA 
move.| a0,al 


TableALoop: 
move.| dO,(al)+ ; alles Abbruch- 
add.| d1,dO ; Descriptoren 
dbra d2,TableALoop 
lea 512(a0),al ; Adresse TableB 
addq.w #2,a1 ‚2 = TableDescriptor 
move.| a1,(a0) ; 1. Eintrag in TableA 
subq.w #2,a1 ; korekte TableB-Adresse 
moveq #127,d2 
moveq #1,d0 


move.| #$40000,d1 ; Schrittweite = 256 KByte 
TableBLoop: 

move.| dO,(al)+ ‚ alles Abbruch- 

add.| d1,dO ; Descriptoren 

dbra d2,TableBLoop 


move.| ROMAdr,dO 


adda.w #5,dO ;5 = Seitendesc. u. WP= 1 
move.| d0,512+248(a0) ‚1. 256 KByte vom ROM 
add.| #%40000,d0 

move.| d0,512+252(a0) ‚2. 256 KByte vom ROM 


move.|l #"FAST",1024(a0); Kennung für FASTROM 
move.| #"V1.0",1028(a0); Version 
move.|l ROMAdr, 1032(a0) 
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move.| NewCRP +4,1036(a0) 
rts 


;--- Error-Routine --- 


Error: 


move.| ROMAdr,dO 

beq Error_2 

move.| dO,al 

move.| #%80000,d0 ; ROM-Länge 

move.| 4,36 

jsr -210(a6) ; FreeMEM () 
Error _2: 

move.| NewCRP-+4,d0 

beq Error _3 


move.| dO,al 
move.| #TableSize,dO 


move.| 4,36 

jsr -210(a6) ; FreeMEM () 
Error_3: 

lea TextError,aO 

bsr PrintText 

moveq #0,d0 

rts ; Programmende 


;-- MMU wird schon benutzt --- 


MMuUlInlise: 
lea TextUSE,a0 
bsr PrintText 
moveg #0,d0 
rts 
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;-- Keine MMU vorhanden --- 


NO MMUu: 
lea TextNoMMU,a0 
bsr PrintText 
moveq #0,d0 
rts 


--- Speicher reservieren 
- DO = Größe, 
- Di =Teiler, durch die die Adresse glatt geteilt werden kan . 


AllocTeilerMEM: 
movem.| dO-d1,-(sp) 
add.| d1,dO 
move.| #$10005,d1 ; FAST + Public + Clear 
move.| 4,36 


jsr -198(a6) ; AllOcCMEM () 

movem.| (sp)+,d1-d2 

tst. | do 

beq AllocTMEnd 

move.| d2,d3 ; Teiler retten 

move.| dO,al 

add.| d2,dO ; Adresse + Teiler 

subq.| #1,d2 ; Teiler -1 

not.| d2 ‚ Maske für Teilerbits 

and.| d2,dO ‚ untere Teilerbits der Adr. löschen 


movem.| dO-d1,-(sp) 

move.| d1,dO 

add.| d3,dO 

move.| 4,a6 

Isr -210(a6) ; FreeMEM () 
movem.| (sp) + ,‚dO-d1 
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move.| dO,al 

move.|l d1,dO 

move.| 4,36 

jsr -204(a6) ;‚ AllocABS 
AllocTMEnd: 

rts 


;--- Text ausgeben --- 


PrintText: 
move.| a0,-(sp) 
lea dosname,al 
moveq #0,d0 
move.| 4,36 
jsr -552(a6) ; OpenLibrary () 
move.| (sp)+ ‚a0 
sub.| a6,a6 
tst.| do 
beq PT_End 
move.|l dO,a6 
move.| #RAWWindow,dI 
move.| #1005,d2 ; Mode = OLD 
move.| a0,-(sp) 
jsr -30(a6) ; OPEN () 
move.| (sp)+ ‚a0 
move.| dO,d1 ; Handle 
beq PT End 
move.|l a0,d2 ;‚ Textadresse 
moveq #0,d3 
PT_Size: 
tst.b  (a0)+ 
beq PT_SizeEnd 
addq.w #1,d3 
bra PT_Size 
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PT_SizeEnd: 
move.| d1,-(sp) 
jsr -48(46) ; Write () 


move.| (sp)+,d1 
move.| #2000000,d2 ; Timeout 
move.| d1,-(sp) 


jsr -204(a6) ; WaitForChar () 
move.| (sp)+,d1 
jsr -36(a6) ; CLOSE () 
PT_End: 
move.| a6,dO 
beq PT _End2 
move.| a6,a1l 
move.| 4,36 
jsr -414(a6) ; CloseLibrary () 
PT_End2: 
rts 
;-—- Parameter ---- 
OIdTC: dc.| O 
CI TC: dc.| O 


NewTC: dc.! $80407750 


OIdCRP: dc.l 0,0 
NewCRP: dc.| $2,0 


ROMAdr: dc.| 0 
OldsP:  delo 


dosname: dc.b "dos.library",O 
even 


RAWWindow: dc.b "RAW:0/10/320/50/--- FastRom-Information --",0 
even 
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TextError: dc.b "Kann FASTROM nicht installieren" ,O 
even 

TextUSE: dc.b "Error: MMU wird schon benutzt" ,‚O 
even 

TextNoMMU: dc.b "Error: keine MMU vorhanden" ,O 
even 

TextMMUON: dc.b "FASTROM jetzt eingeschaltet",O 
even 

TextMMUOfFf: dc.b "FASTROM jetzt ausgeschaltet",O 
even 


END ; Listingende 
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1.14 Programmierrichtlinien 


Bis zum Kickstart V1.3 hatte man sich überhaupt keine Gedanken um 
Kompatibilität gemacht. Es wurde noch so programmiert, wie es die 
meisten von den 8-Bit-Rechner her kannten. Dort hatte man sein 
Betriebssystem immer an der gleichen Adresse und Erweiterungen 
gab es überhaupt nicht. Zu den Amiga-Anfangszeiten haben viele 
Programmierer ganicht in Betracht gezogen, daß die Entwicklung in 
bezug auf Kickstart und Prozessoren weitergehen wird. Dieses führte 
natürlich, mit der Enführung von 0S2.0 und höher zu katastrophalen 
Auswirkungen. Viele Programme verweigerten ihren Dienst oder 
brachten das ganze System zum Absturz. 


Commodore hatte schon frühzeitig Richtlinien für die Gestaltung und 
Programmierung von Software herausgegeben. Besonders ab 052.0 
sollten diese eingehalten werden. Mittlerweile besitzen die meisten 
Programme auch eine einheitliche Oberfläche, so daß sich der 
Anwender schnell zu recht findet und sich nicht jedesmal umstellen 
muß. 


Die häufigsten Probleme entstehen immer noch auf Grund von 
Unkenntnis über die neueren Prozessoren. Viele wissen nichts mit 
Cache und Co-Prozessoren anzufangen. Ich hoffe, daß sich das mit 
diesem Buch ändert. 


Welche Regeln man besonders beachten sollte, werden wir jetzt kurz 
beschreiben. 


1) Adressen des Betri m 


Das derzeitige Betriebssystem (0S3.1) liegt im Adreßraum von 
$F80000 bis $FFFFFF (512 KByte). Man sollte sich aber nicht darauf 
verlassen, daß die Adressen der jeweiligen Funktionen auch bei 
späteren Versionen die gleichen sind. Also niemals feste Adresse des 
Kickstarts benutzen. 
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2) selbstmodifizierender Code 


Seit dem M(C68020 besitzen die Prozessoren einen internen Cache. 
Verwenden Sie jetzt selbstmodifizierenden Code im Programm, kann 
es sein, daß der Cache noch die alten Daten enthält, wenn der 
Programmcounter an der entsprechende Stelle ankommt und somit 
falsche Daten bzw. Befehle verarbeitet werden. Abhilfe schaffen hier 
einige Exec-Funktionen (ab 052.0) auf die wir bereits im Abschnitt 
1.11 eingegangen sind. 


3) Librarybasis A6 


Die verschiedenen Libraries des Systems verlangen immer im Adreß- 
register Ab die Basisadresse. Benutzen Sie auf keinen Fall ein anderes 
Adreßregister. Das Register enthält auch nach dem Aufruf mit 
Sicherheit den gleichen Wert. 


4) Parameter für Library-Funktionen 


Alle Paramter müssen für einen Funktionsaufruf in den entsprechen- 
den Registern enthalten sein. Benutzen Sie zusätzlich eigene Register, 
müssen Sie diese vor dem Aufruf der Funktion retten. Nach dem 
Aufruf können alle Register einen anderen Wert aufweisen und Sie 
würden dann mit den falschen Werten weiter arbeiten. 


5) Ergebnis von Library-Funktionen 


Nach einem Aufruf einer Funktion sollten Sie immer testen, ob dieser 
erfolgreich war, um die Verwendung falscher Werte vorzubeugen. 
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6) Schleifenprogrammierung 


Verwenden Sie. für Wartezeiten niemals Prozessorschleifen. Die Zeiten 
sind auf den jeweiligen Prozessoren (Taktfrequenzen) andere. Das ist 
auch oft der Grund, warum Schnelllader von Diskettenspielen auf 
höheren CPUs nicht mehr booten bzw. laden. Programmieren Sie 
lieber die Timer entweder direkt über die Hardware (Vosicht) oder 
über Systemroutinen (LowLevel-Library). Oft kann auch die interne 
parallele Verarbeitung der neueren CPUs dazu führen, daß bestimmte 
Programmteile nicht mehr so funktionieren, wie sie sollten (Disketten- 
programmierung -> Lesekopf bewegen). Meistens hilft hier schon 
die Einführung eines NOP-Befehls, der die serielle Verarbeitung von 
Programmcode erzwingt. Für die Systemprogrammierung sollten Sie 
auch keine Maustasten oder dergleichen abfragen, um zum Beispiel 
auf die Betätigung eines Gadget oder Menüpunktes zu warten. 
Verwenden Sie lieber die WAIT-Funktionen der Exec-Library (siehe 
Abschnitt 5). 


7) reservierte Register und Strukturen 


Auf die Belegung der Custom-Register sind wir schon eingegangen. 
Die Anzahl und Bitbelegung ist somit fest vorgegeben. Daraus 
resultiert jedoch nicht die beliebige Nutzung der freien Plätze. In 
späteren CHIP-Sätzen können und werden auch weitere 
hinzukommen. Das Selbe gilt für Einträge in Strukturen, die für 
spätere Erweiterungen reserviert sind. 
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1.15 CODE-Optimierung 


Unter CODE-Optimierung versteht man, sein Listing so strukturiert zu 
halten, daß ein Außenstehender schnell den Durchblick findet. Dabei 
sollte der Source-Code nicht nur übersichtlich, sondern auch gut pro- 
grammiert sein, in Hinsicht auf Ausführungszeit und Code-Länge. 


Auch wenn der M(C68000 im Prinzip schon ein recht schneller 
Prozessor ist, sollte man nicht dazu neigen, "schlechten" Maschinen- 
code zu programmieren, denn da könnten sich schnell ein paar 
tausend Taktzyklen aufeinander addieren, gerade bei der Schleifen- 
programmierung, die man hätte einsparen können. 


Zum Beispiel verwenden viele Programmierer, insbesondere 
Anfänger, den Maschinenbefehl "CLR.| Dx" um ein Datenregister zu 
löschen. Geeigneter wäre hier "MOVEQ #0,Dx". Die erzeugte 
Maschinencodelänge ist dieselbe, aber es werden 2 Zyklen 
eingespart. Der Befehl hat zudem weitere Einsatzmöglichkeiten, z. B. 
das Laden eines Wertes in ein Datenregister (moveq #100,d0 statt 
move.| #100,d0). 


Viele Programmierer beachten nicht (auch Profis), daß Zugriffe auf 
Adreßregister immer vorzeichenrichtig auf Longgröße erweitert 
werden. ADD.w #10,AO spart gegenüber ADD.| #10,AO 2 Takzyklen 
und 2 Bytes. 


Da ich nicht auf alle möglichen Optimierungen ausführlich eingehen 
möchte, das würde sowieso viel zu lange dauern, folgt hier eine Liste 
von Optimierungsbeispielen, nach der Sie sich richten können und 
auch sollten. 
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optimiert nicht optimiert 
moveg #0,d0 (4) clr.! dO (6) 
moveq #120,d0 (4) move.x #120,d0 (8-14) 
addq #4,a0 (8) add.x #4,a0 (12-14) 
add.w #1000,a0 (12) add.| #1000,a0 (14) 
lea label(pc),a0 (8) lea _label,a0 (12) 
moveq #3,d0 (4) move.| #3,label (28) 
move.| dO,label (20) 
lea tabelle(pc),a0 (8) lea tabelle,a0 (12) 
movem.| (a0),dO-d3/al (40) move.| (a0),dO (12) 
move.| 4(a0),d1 (16) 
move.| 8(a0),d2 (16) 
move.| 12(a0),d3 (16) 


move.| 16(a0),a1 (16) 


move.| dO,d1 (4) mulu #10,d0 (74) 
si. #2,d1 (12) 
add.| d1,dO (8) 
add.! dO,dO (8 
add.w dO,dO (4) Isl.w #2,d0 (10) 
add.w dO,dO (4) oder mulu #4,d0 (74) 
not.x_dO (4-6) eor.x #$ff,dO (8-16) 
bsr label (18 isr label (20 
bra label (10 imp label (12 
move.| (a0),dO (12) move.| (a0),dO (12) 
beq.b label (10/8) tst.| dO (4) 
beq label (10/12) 
move.| a0,dO (4) cmp.| #0,a0 (14) 
bea.b label (10/ beg label (10/12 
ror.w #4,d0 (14) Isl.w #8,dO (22) 
Isl.w #4,d0 (10) 
moveq #7,d0 (4) and.| #7,d1 (14) 
and.| dO,d1 (8) sub.| #30,d1 (14) 


moveq #30,d0 (4) 
sub.| dO,d1 (8) BE 3 ARTE 
sub.| a0,a0 (8) move.| #0,a0 (12) oder lea 0,30 (12) 
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moveg #99,d0 (4) 
lea ascii(pc),aO (8) 
lea puffer(pc),a1 (8) 
loop: 
move.b (a0)+,d1 (8) 
add.b d1,dI (4) 
ror.b #4,d1 (14) 
not.b d1 (4) 
move.b d1,(al)+ (8) 
dbra dO,loop (10/14) 
rts (16) 
=> (4840) 


loop: 


move.w #100,d0 (8) 
lea ascil,a0 (12) 
lea puffer,al (12) 


move.b (a0)+,d1 (8) 
jsr codiere (20) 
move.b d1,(al)+ (8) 
sub.w #1,d0 (8) 
tst.w dO (4) 

bne loop (10/12) 

rts (16) 

codiere: 

add.b d1,d1 (4) 
ror.b #4,d1 (14) 
not.b di (4) 

rts => (16) 

=> (9650) fast das Doppelte 


Die den Maschinenbefehlen nachstehenden Klammern beinhalten die 


benötigten Taktzyklen der Befehle. 


Das waren jetzt nur einige Beispiele zur Codeoptimierung. Es gibt 
natürlich noch weitaus mehr, aber die hier genannten sind wohl die 
einfachsten und verbreitesten Optimierungen, nach denen Sie sich auf 


jeden Fall richten sollten. 
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1.16 Beispiele 


Zum Abschluß des Kapitels folgt noch ein kleines Beispiellisting, 
welches das Betriebssystem aus- und einschaltet. Das Listing werden 
wir später, etwas abgeändert, in fast jedem Beispiel einbauen, damit 
wir nicht mit dem System in Konflikt kommen. 


Damit wir am Ende unseres Programmes wieder zum System zurück- 
schalten können, müssen wir am Anfang den Wert des Interrupt- und 
DMA-Kontrollregisters retten und die Adresse der Interruptebene, die 
genutzt werden soll. 


Beispiellisting zum Ausschalten des Systems: 


SystemOff: 
movem.| dO-d7/a0-a6,-(sp) ; Alle Register retten 
move.| 4,36 ; Execbase nach Adressregister A6 
jsr -120(a6) ; Interrupts verbieten (Disable) 
move.w #255,d0 ; PageO retten 
lea pageO(pc),a0 
sub.| a1,al ; Vektoranfang 

SystemOff_loop!: 
move.| (a1)+ ,(a0)+ ; Vektoren kopieren 
dbra dO,SystemOff_loop 1 

ExceptionStart: 
move.| #ExceptionStart,$20 ; Privileg.-Exceptionadresse 
move.w #$2700,sr ; Privilegsverletzung (SR = 1 und IRQ-Level 7) 
addaq.! #6,a7 ; alten Inhalt vom Stapel 
move.| a7,oldstapel ; alten Stapel retten 
lea NewStack,a7? ‚ eigenen Stackpuffer anlegen 
lea $dff000,a0 ; Custom-Basisadresse 
move.w $1c(a0),old_intena ; Interrupt-Kontrollreg. retten 
move.w $2(a0),old dmacon ; DMA-Kontrollreg. retten 
move.| #NewIRQ,$6c ; eigene Interrupt-Routine einb. 
move.w #$7fff,$9a(a0) ; Interrupts sperren 
move.w #$c020,$9a(a0) ; Vertikal-Blank IRQ erlauben 
move.w #$7fff,$96(a0) ; DMA-Kanäle sperren 
move.w #$83d0,$96(a0) ; BPLEN, COPEN, BLTEN, DSKEN-DMA erlauben 
move.w #$2000,sr ; Supervirsor = 1, IRQ-Level = O 


; ab hier steht eigenes Programm 
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Beispiellisting zum Einschalten des Systems: 


SystemOn: 
move.w #$2700,sr ; höchster IRQ-Level 
lea $dff000,a0 ; Custom-Basisadresse 
or.w #$8000,old_intena ; SET/CLR-Bit setzen 
or.w #$8000,0ld_dmacon 
move.w #$ 7fff,$9a(a0) ; Inerrupts verbieten 
move.w #%7fff,$96(a0) ; DMA-Transfer verbieten 
move.w old _intena, $9a(a0) ; alte Interrupts setzen 
move.w old dmacon,$96(a20) ; alte DMAs setzen 
move.w #255,d0 ; PageO zurückschreiben 
lea pageO(pc),a0 
sub.| al,al ; Vektoranfang 

SystemOn loop]: 
move.| (a0)+ ,(a01+ ; Vektoren kopieren 
dbra dO,SystemOn_loop 1 
move.| old _stapel,a7 ; alten Stackbereich 
move.w #50000,sr ; Supervisor = 0, IRQ-Level = 0 
move.| 4,6 
jsr -126(a6) ; Interrupts erlauben (Enable) 
movem.! (sp) + ‚dO-d7/a0-a6 ; Register zurückholen 
rts ; Ende 

;—— Beispiel-Interrupt-Routine ---- 

NewiIRQ): 
move.w #$20,$dff09c ; IRQ zurücksetzen 
movem.| dO-d7/a0-a6,-(sp) ‚Register retten 


; hier steht IRQ-Programm 


movem.| (sp) + ‚dO-d7/a0-a6 ‚Register zurückschreiben 
RTE 


;— Parameter für SystemAn/Aus ---- 
PageO: bik.! 256,0 
old stapel: dc.lO 


NewStack end: 
bik.| 1000,0 
NewsStack: dc.| O 


old_intena: dc.w O 
old dmacon: dc.w O 
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2. Das Amiga-Diskettenformat 


Eine Diskette ist global gesehen nichts weiter als eine flache runde 
Scheibe, vergleichbar mit einer Schallplatte, allerdings mit dem 
Unterschied, daß sie nicht nur eine einzige fortlaufende Spur besitzt, 
sondern mehrere jeweils in sich abgeschlossene. 


Beim Amiga sind es 80 Spuren auf jeder Seite, die von außen nach 
innen durchnummeriert werden (siehe Bild 2.a). Die Informationen, 
die Sie mit Hilfe des Amigas auf der Diskette sichern wollen, werden 
in den einzelnen Spuren untergebracht. Dazu wird jede Spur 
nochmals in 11 Blöcken, auch Sektoren genannt, aufgeteilt. Jeder 
dieser Blöcke kann 512 Bytes Informationen aufnehmen (1 Byte = 1 
Zeichen). 


Vorderseite (Seite 8) Rückseite (Seite 1) 
RED en u rt En 








Über ein Magnetisierungsverfahren werden die Informationen auf 
Diskette gespeichert. Auf dieses Verfahren werden wir später noch 
eingehen. 
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Hochgerechnet ergibt das eine Speicherkapazität von: 


- 80 Spuren mal 2 Seiten = 160 Tracks 

- 1 Track = 11 Sektoren (Blöcke) 

- 160 Tracks mal 11 Sektoren = 1760 Blöcke 

- 1 Block = 512 Bytes Informationen 

- 1760 Blöcke mal 512 Bytes = 901120 Bytes Informationen 
- 1 KByte = 1024 Bytes 

- 901120/1024 = 880 KByte Datenkapazität 


Wie wir errechnet haben befinden sich 1760 Blöcke auf einer 
Diskette. Diese werden fortlaufend von O bis 1759 durchnummeriert. 


Der erste Block (Nummer O) befindet sich auf Spur O, Seite O und 
Sektor O. Der 12. Block (Nummer 11) befindet sich nicht etwa auf 
Spur 1, Seite O und Sektor O, sondern auf der Rückseite, also Spur O, 
Seite 1 und Sektor O. Denn die Seiten werden abwechselnd bespielt 
(siehe Bild 2.a). 


2.1 Diskettenzugriff ohne DOS 


Bevor wir nun Daten auf Diskette bzw. von Diskette transferieren 
können, sind noch eine große Anzahl an Vorbereitungen zu treffen. 


Da wir das Diskettenlaufwerk direkt über die Hardware program- 
mieren wollen, wird als erstes dem System jeglicher Zugriff auf das 
Diskettenlaufwerk untersagt. Ansonsten könnten Kompatibilitätspro- 
bleme auftreten und der Guru würde meditieren. Das bedeutet im 
Klartext, daß alle Interrupts ausgeschaltet und falls nötig, eigene ein- 
geschaltet werden. Am einfachsten kann man die Interrupts mit der 
Funktion Disable () aus- und mit Enable () wieder einschalten. Diese 
sind in der Execlibrary zu finden und benötigen keine Parameter. 
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Interrupts ausschalten: 


move.| 4,36 ; Execbasis nach a6 
jsr -120(a6) ; Funktion Disable 


; hier steht z. B. 
; eigenes Programm 


Interrupts wieder einschalten: 


move.| 4,36 ‚ Execbasis nach a6 
jsr -126(a6) ; Funktion Enable 


Das obige Beispiel funktioniert zwar einwandfrei, jedoch ist es für 
unsere weitere Hardwareprogrammierung, speziell für die Interrupt- 
programmierung ungeeignet. Deswegen sollten Sie das Beispiel aus 
Kapitel 1 oder aus den Beispiellistings bzgl. des Game-Animators 
benutzen. 


Außerdem müssen wir noch den Wert des ADKCON- Registers retten, 
da wir es für unsere eigenen Zwecke verändern werden. 


alten ADKCON retten: 
move.w $dff010,dO 
bset #15,d0 
move.w dO,old_adkcon 


alten ADKCON herstellen: 


move.w #$7f00,$dff09e 
move.w old _adkcon, $dff09e 


old adkcon: dc.w O 
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2.2 Aufzeichnungsverfahren 


Der Datentransfer zwischen Computer und Diskettenlaufwerk 
geschieht bitweise. Das heißt, die Daten werden bitweise auf die 
Diskette geschrieben bzw. von der Diskette gelesen. 


Beim Speichern werden die Datenbits in einer bestimmten Taktfre- 
quenz in Stromimpulse umgewandelt und zum Schreib/Lesekopf des 
Laufwerks geschickt. Dieser Schreib-/Lesekopf erzeugt durch Induktion 
ein Magnetfeld und speichert dadurch die Bits (Impulse) auf der 
Diskette. Dabei werden die Bits nicht durch unterschiedliche 
Magnetisierung auf der Diskette gekennzeichnet, sondern durch 
Magnetisierungswechsel, Innerhalb eines bestimmten Takts stellt ein 
Wechsel ein 1-Bit und eine gleichbleibene Magnetisierung ein O-Bit 
dar. 


Beim Lesen werden, während der Schreib/Lesekopf über einen Track 
fährt, durch die magnetisierte Trägerschicht der Diskette Impulse 
erzeugt, die wieder in Bits gewandelt und in den Speicher 
geschrieben werden. 


Aufgrund von Laufwerkschwankungen dürfen die Phasen der gleich- 
bleibenen Magnetisierung nicht zu lang sein, da sonst der Controller 
aus dem Takt kommt. Deshalb müssen die Daten vorher so codiert 
werden, das es nicht dazu kommen kann. 


Der Amiga kennt zwei Codierungsarten; das MFM- und das GCR- 
Verfahren, welche in den folgenden Abschnitten beschrieben werden. 
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2.2.1 Das MFM-Format 


Der Amiga codiert die Datenbits im MFM-Format bevor sie auf 
Diskette geschrieben werden. Dabei werden nicht nur die Datenbits 
geschrieben, sondern zusätzlich noch zwischen zwei Datenbits ein 
sogenanntes Taktbit. Damit erhöht sich die Bitanzahl, die auf Diskette 
gespeichert werden, auf das Doppelte. 


Dieses Taktbit gewährt, daß der Controller nicht aus dem Takt 
(Synchronisation) kommt. Es können dabei weder mehrere 1-Bits 
nebeneinander auftreten, noch mehr als drei O-Bits. Dies ist sehr 
wichtig, da der Controller nicht in der Lage ist einen zu schnellen 
Magnetisierungswechsel fehlerfrei zu erkennen. 


Das MFM-Codierprinzip ist folgendermaßen aufgebaut: Wenn eines 
der benachbarten Datenbits eine "1" ist, so wird ein O-Taktbit 
dazwischen eingefügt, sind beide benachbarten Datenbits "0", so 
wird ein 1-Taktbit eingefügt. Dabei wird von rechts nach links 
vorgegangen. 


Beispiel für die Codierung des Wertes $8104: 


Hexwert : $ 8104 

Binärwert: % 1000000100000 100X0 
TarktnDite = SsD EL 1111 61411 18 03 
Ergebnis : % O1001010101010010010101010010010 


Hexwert des Ergebnis = SFAAGLAIL 


Falls man das Ergebnis zwischen zwei codierte Werte einfügen 
möchte, muß darauf geachtet werden, daß nicht mehr als drei O-Bits 
hintereinander auftreten. Würden wir obiges Ergebnis einfügen 
wollen, ginge das ohne Probleme, da das letzte Datenbit (Bit 30) 
eine 1 ist. Wenn aber das letzte Datenbit eine O ist, so können wir 
nicht einfach ein O-Bit als letztes Taktbit (Bit 31) einfügen. 
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Im Falle das das letzte Datenbit (Bit 30) eine "0" ist und wir fügen 
noch als letztes Taktbit (Bit 31) eine "0" ein, so könnten, wenn der 
vorangegane Codierte Wert bei den Bits O und 1 auch eine "0" 
stehen hätte, vier O-Bits hintereinander auftreten. 


Um dies zu verhindern, müssen wir folgendermaßen vorgehen (nur 
wenn ein codierter Wert hinter einen bereits codierten eingefügt 
werden soll): 


7) Das letzte Taktbit (Bıt 31) löschen 

2) Das letzte Datenbit (Bit 30) abfragen ob es gesetzt ist, wenn Ja 
oann st alles O,K., wenn nicht dann Folgt Punkt 3 

3) erstes Datenbit (Bit 0) vom vorangegangen codlierten Wert testen, 
wenn es gesetzt Ist, dann OK, wenn nicht, dann letztes Taktbit 
(Bit 31) auf "1" setzen 


Hier ein kleines Programmbeispiel: 


;-- DO =codierter Wert ---- 
lea codepuffer,a0 ; Puffer wo codierte Daten liegen 


move.| dO,(a0) ; codierten Wert einfügen 

bcIr #7 (a0) ; Bit 31 löschen (letztes Taktbit) 

btst #6,(a0) ; Bit 30 testen (letztes Datenbit) 

bne OK ; wenn Bit 30 = 1 dann OK 

btst #0,-1(a0) ; Bit O (erstes Datenbit) vom vorangegangem 


Wert testen 


-.- 


bne Ok ; wenn BitO = 1 dann OK 
bset #7 (a0) ‚ sonst Bit 31 setzen 

OK: 

rts 


Dieses Beispiel werden wir in etwas abgeänderter Form noch später 
für die Codierung eines Tracks benutzen, um die sogenannten 
"Ränder" zu testen. 
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Wenn wir die Daten codiert auf Diskette geschrieben haben und 
anschließend wieder in den RAM-Speicher laden möchten, so würde 
der Disk-Controller an einer zufälligen Stelle beginnen, die codierten 
Daten einzulesen. Somit müßten wir die Bits erst "zurechtschieben", 
bevor wir sie decodieren könnten. Das würde natürlich funktionieren, 
aber auf Kosten der Rechenzeit. Der Amiga bietet daher noch die 
Möglichkeit auf eine bestimmte Sync-Markierung (Synchronisation) zu 
warten, bevor der Disk-Controller die Daten beginnt einzulesen. 


Eine solche Sync-Markierung ist ein 16-Bit MFM-Wert, welcher nicht 
durch eine normale Codierung zustande kommen kann. Üblicherweise 
wird hier der Wert $4489 genommen. 


Wenn der Disk-Controller diesen Sync-Wert auf Disk gefunden hat, 
beginnt er direkt danach die codierten Daten einzulesen. Selbst wenn 
beim Lesen eine weitere Sync-Makierung auftauchen sollte, so wird 
diese miteingelesen. Der Lesevorgang wird erst "unterbrochen", wenn 
die eingestellte Anzahl der Datenworte ins RAM übertragen wurde. 


Das Betriebssystem liest die codierten Daten ohne Sync-Markierung 
ein, was mit ein Grund für die langsame Übertragung ist. Dieses 
Verfahren hat aber den Vorteil, daß jeder noch so zerstörte MFM- 
Track gelesen werden kann. 


2.2.2 Das GCR-Format 


Das zweite Codierungsverfahren, das der Amiga kennt aber nicht 
selbst benutzt, ist das GCR-Prinzip (Group-Code-Recording). 


Im GCR-Verfahren werden immer vier Datenbits zu einer Kombination 


von fünf GCR-Bits codiert, dadurch wird gewährleistet, daß nicht 
mehr als zwei O-Bits oder acht 1-Bits nebeneinander auftreten. 
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Da bei diesem Format mehrere 1-Bits nebeneinander auftreten 
können, muß die Datenaufzeichnungsdichte auf die Hälfte verringert 
werden (von 2 auf 4 ms), damit der Disk-Controller nicht aus dem 
Takt gerät. 


Da immer vier Datenbits zu fünf GCR-Bits codiert werden, gibt es 16 
verschiedene GCR-Kombinationen (vier Bits = 2 hoch 4 => 16 Kom- 
binationen): 


Datenhexwert Datenbinärwert_ => _ GCR-Binärwert 
$00 %0000 %01010 
$01 %0001 %01011 
$02 0010 %10010 
$03 %001 1 %10011 
504 %0100 %01110 
$05 %0101 %01111 
$06 %0110 %10110 
$07 %0111 %10111 
08 %1000 %01001 
$09 %1001 %11001 
H0A %1010 %11010 
$0B %1011 %11011 
H0C %1100 %01101 
$0D %1101 %11101 
$0E %1110 %11110 
$OF %1111 %10101 


Da beim Codieren von einem Bytewert, also 8 Bits das Ergebnis zwei 
Bits größer ist, codiert man immer vier Datenbytes (32 Bits) 
aufeinmal zu fünf GCR-Bytes, damit keine Bits überbleiben. 


Beispielcodierung des Hexadezimalwerts $135f3476: 


Hexwert: u | 3 5 f 3 4 7 6 
Binärwert: % 0001 0011 0191 2171 0011 0100 0311 0110 
GCR-Binärwert: % 01011 10011 O1111 10101 10011 01110 10111 10110 
GCR-Hexwert: $ SCDF59BAF6 
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Auch hier kann man den Disk-Conroller auf eine Sync-Markierung 
warten lassen. Eine solche Markierung wäre eine Kombination von 
neun oder mehr Bits hintereinander, die nicht durch eine normale 
Datencodierung entstehen kann. Außerdem muß beim Speichern der 
GCR-Bits darauf geachtet werden, daß nach der Sync-Markierung die 
beginnenden Datenbits mit einem O-Bit beginnen. Ein Beispiel hierfür 
wäre: 


Hrffff55 = Sync-Anfang und Ende, $XXXXX = GCR-Datenbits 


2.3 Aufbau eines Tracks 


Wie wir bereits besprochen haben, besteht ein Track aus 11 Blöcken 
von jeweils 512 Bytes (1024 Bytes codiert). Außerdem wird zu jedem 
Block, welcher Datenblock genannt wird, ein Informationsblock 
mitabgespeichert. Dieser Info-Block besitzt eine codierte Länge von 
64 Bytes und ist für die fehlerfreie Erkennung des Datenblocks 
erforderlich. 


Da ein Track rund ist, muß sichergestellt sein, daß beim Speichern 
die letzten Daten nicht die ersten wieder überschreiben. Deswegen 
befindet sich zwischen dem ersten und letzten Block eine Tracklücke, 
die kleiner ist als ein vollständiger Block. Die genaue Länge ist von 
Laufwerk zu Laufwerk, aufgrund der Laufwerkschwankungen, 
unterschiedlich. Zudem ist die Länge auch nicht wichtig, da die 
Tracklücke keine sinnvollen Daten besitzt. Sie müssen beim Speichern 
eines Tracks nur darauf achten, daß Sie die Tracklücke zuerst 
schreiben, damit der letzte Block nur die Tracklücke ein wenig 
überschreibt statt den ersten Block. 
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Wenn wir alles zusammenrechnen, kommen wir auf eine ungefähre 
Tracklänge von: 


- 1 Block = 1 Datenblock + 1 Info-Block = 512 + 64 = 1088 Bytes 
- 11 Blöcke = 11 * 1088 = 11968 Bytes 
- 11 Blöcke + Tracklücke = 11968 + ca. 700 = 12668 Bytes 


Tracklänge ca. 12668 Bytes 


Die folgende Grafik zeigt den prinzipiellen Aufbau eines Tracks. Die 
Tracklücke befindet sich dabei zwischen dem ersten und letzten Block. 


ACHTUNG! \Wenn Sie einen Track in den Speicher laden, kann die 
Tracklücke sich auch zwischen zwei anderen Blöcken befindet (z. B. 
zwischen Block 2 und 3 oder 5 und 6). Denn der Disk-Controller lädt 
die Daten ja ab einer beliebigen Position in den Speicher und nicht 
ab Block 0. Außerdem ist nicht festgelegt, nach welchem Sektor 
(Block) die Tracklücke stehen soll. 


Info- |Data- Info- |Data- Info- 
Blook®| Blookß | Blooki| Blooki al re 





Bild 2.b 
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Aufbau _des Info-Blocks (64 codierte Bytes) 
Name hreibu 
00 zwei codierte Nullbytes (kAAAAAAAA) 
04 Syncword zwei Syncwords (44894489) 
08 Info 8 Infobytes (4 codierte Bytes) 
16 Frei 16 codierte Nullbytes (AAAA x 16) 


48 InfoChecksum Checksumme ab Offset 08 bis 47 
56 DataChecksum Checksumme über Datenblock 
64 Ende 


Die 4 Infobytes (8 codierte Bytes) ab Offset 8 enthalten folgende 
Informationen: 


me hrei 
00 Format Formatkennzeichen ($FF) 
01 Track Tracknummer (0 bis 159) 
02 Sektor Sektornummer (0 bis 10) 
03 Sektorlücke Anzahl Blöcke (Sektoren) bis Tracklücke 


Das Formatkennzeichen kennzeichnet das Aufzeichnungsverfahren des 
Amiga ($FF). Fehlt das "$FF"- Formatzeichen, wie zum Beispiel bei 
MS-DOS Disketten, die auch im MFM-Format codiert sind, so liegt die 
Diskette nicht im Amiga-Format vor. 


Die Tracknummer gibt an, zu welchen Track der Block gehört. Hier 
muß bei jedem Block die Tracknummer stehen, welcher zuvor auch 
gelesen wurde. 


Die Sektornummer gibt an, um welchen Sektor es sich handelt der 
gelesen wurde (Nummer O bis 10). Falls eine Sektornummer zweimal 
vorkommt, so liegt in der Regel ein Fehler vor. 


Das letzte Byte gibt an, wieviel Sektoren (Blöcke) noch verbleiben bis 
zur Tracklücke. Der Wert Eins bedeutet, daß nach diesem Sektor 
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(Block) die Tracklücke folgt (die Nummer darf nicht größer als 11 
sein). Dieses Byte ist sehr wichtig, da wie schon besprochen, die 
Tracklücke sich nach jedem Sektor befinden kann. 


Wenn die vier Bytes codiert (MFM) werden, ergeben sie eine Länge 
von 8 Bytes und gehen deswegen von Offset 8 bis einschließlich 15. 


Die Prüfsummen werden unten weiter besprochen, da dafür Pro- 
grammbeispiele erforderlich sind. 


Aufbau des Datenblocks (1024 codierte Bytes) 


Die 512 Bytes des Datenblocks werden zu 1024 MFM-Bytes codiert. 
Dabei werden die codierten Longwords nicht hintereinander 
abgelegt, sondern in Abständen von 512 Bytes. 


Das heißt, daß das erste Daten-Longword (die ersten vier Bytes) zu 
zwei MFM-Longwords codiert wird, wobei das erste codierte 
Longword ab Offset O und das zweite ab Offset 512 geschrieben wird 
USW. 


Möchte man die Daten wieder decodieren, so faßt man jeweils das 
erste (Offset O0) und 128 (Offset 512), das zweite (Offset 4) und 129 
(Offset 516) Longword usw. zusammen. 


Die Prüfsummen (Info- und Datenblock) 


Die Prüfsummen finden wir in dem Info-Block ab Offset 48. Sie sind 
für die fehlerfreie Erkennung eines Tracks erforderlich, um zum 
Beispiel Datenverluste durch Staubkörner auf der Diskette zu 
vermeiden. 


Die Prüfsumme über den Info-Block wird nur über den codierten 


Info-Teil und die 16 codierten Nullbytes gebildet (Offset 8 bis 47); 
also 40 Bytes = 10 Longwords. 
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Die Prüfsumme über den Datenblock wird über alle 1024 codierten 
MFM-Bytes berechnet; also 256 Longwords. 


Hier folgt ein Listing, welches die Prüfsumme über den gewünschten 
Block berechnet. Dazu muß in Adressregister AO die Anfangsadresse 
des gewünschten Blocks und im Datenregister D1 die entsprechende 
Bytelänge (40 oder 1024 Bytes) stehen. Im Datenregister O0 wird 
dann die Checksumme zurückgegeben. 


;--- Prüfsummenberechnung zit 
;-- (AO,D1) (Block,Länge) a 
;—- => DO =Prüfsumme PR 


GetChecksum: 

move.| d2,-(sp) ;D2 retten 

Isr.w #2,d1 ‚Anzahl Longswords ermitteln 
subg.w #1,d1 ;Schleifenanzahl ermitteln 
moveq #0,d0 ‚Ergebnis löschen 

GC5S_ Loop: 

move.| (a0)+,d2 ; Longword holen 

eor.| d2,dO ;Exclusive-Oder verknüpfen 
dbra d1,GCS_Loop ;Schleifenanzahl durchlaufen 
and.| #$55555555,dO ‚ungültige Bits herausfiltern 
move.| (sp) + ,d2 ;D2 zurückholen 

rts 


Es folgt ein Listing, was mit Hilfe des Blitterss die Checksumme 
berechnet. Das Listing mag auf den ersten Blick zwar länger sein, 
aber in der Ausführungzeit ist es erheblich schneller. Beim Berechnen 
der Checksumme über den Datenblock ist es mehr als 50 % 
schneller. Allerdings muß zusätzlich im Adreßregister Al eine Adresse 
übergeben werden, die auf vier freie Bytes im CHIP-Speicher zeigt. 
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;--- Checksumme über Datenbereich berechnen 
;-- (mit dem Blitter) 

;-- (AO,A1,D1) (Block ,ChipPtr,Länge) 

-- => DO =Prüfsumme 


GetChecksum: 

and.w #$fffc,d1 ; Anzahl Longs mal 2 
Isi.w #4,d1 ;Blittthöhe 

adda.w #2,d1 ;D1 = Blitsize (Höhe * 4) 
moveq #0,d0 

lea $dff000,a6 ;Chipbasis 

move.| dO,(a1) ‚alte Checksumme löschen 
move.w d0,$64(a6) ;BLTAMOD = 0 

moveq #-1,d0 

move.| d0,$44(a6) ;First/LastMask 

moveq #-4,d0 

move.w d0,$62(a6) ; BLTBMOD = -4 
move.w d0,$66(a6) ; BETDMOD = -4 

move.| a0,$50(a6) ; A (Quelle) 

move.| a1,$4c(a6) ; B (Ziel) 

move.| a1,$54(a6) ; D (Ziel) 

move.| #$0dc30000, $40(a6) ; BPLCONO 
move.w d1,$58(a6) ; BLTSIZE 

95 wait: 

btst #14,$2(a6) ‚auf Blitterende 

bne.b gs wait ‚warten 

move.| (a1),dO ; erechnete Checksum holen 


and.| #$55555555,d0 ‚ungültige Bits herausfiltern 
rts 
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2.4 Track codieren 


Nachdem wir über den Trackaufbau gesprochen haben, wollen wir 
diesen jetzt codieren, damit wir ihn auf die Diskette schreiben 
können. Allerdings werden wir hier nicht die umständlichen 
Funktionen des Betriebssystems beschreiben, wie es in fast allen bis- 
herigen Büchern oder Kursen gehandhabt wurde, sondern wir werden 
eine eigene Codier-Routine entwickeln. 


Die Codier-Routine, die wir hier vorstellen werden, codiert allerdings 
nur einen Datenblock. Wenn man einen ganzen Track codieren 
möchte, so müssen nur in Form einer Schleife alle Datenblocks (0 bis 
10) codiert werden. Es wird nur ein Block codiert, da wie wir später 
noch sehen werden, ein File schneller geladen wird, denn es muß 
nicht jedesmal der ganze Track decodiert bzw. codiert werden. 


Es folgt nun die Parameterbeschreibung der Routine CodeBlock () mit 
dem dazugehörigem Listing, das danach noch ausführlich beschrieben 
wird. 


Routine: KCodeBlock (DO-D2,AQ-A1) (Track,Sektor,Mode,Quelle,Ziel) 
Parameter: DO =Tracknummer (0 bis 159) 


D1 = Sektornummer (0 bis 10) 

D2 = 0, Track wird neu erstellt 

D2 = 1, Track befindet sich schon im Speicher 

AO = Adresse des Datenblocks, welcher codiert werden 
soll (512 Bytes). 

A1 = Adresse des Zielpuffers (1024 Bytes), wo die 


codierten Daten abgelegt werden sollen. 
Rückgabe: keine 
Erklärung: 
Diese Funktion codiert einen Datenblock komplett ins MFM-Format 
und testet auch die Ränder. D2 sollten Sie auf den Wert O setzen, es 
sei denn, der Track wurde vorher mit der Routine "ReadMFMTrack()" 
gelesen. 
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;--- Einen Block codieren mit a (InfoBlock) 

»- DO = Tracknummer (O- an = Sektornummer (0 bis 10) -- 
je r Mode: O0 = Neu, I = ee korekter Track im Memory 
je = Quelle, Al = Ziel 

j- A enthalten den selben Wert am Ende 

CodeBlock: 

cmp.w #1,d2 ‚ alter Track noch im Speicher ? 
bne.b codeb I 

lea 64(al),al ; nach Header 

bra.b code_daten 

codeb!: 

move.| #$aaaaaaaa,(al) ; NullBytes 


;-- Bit 31 von Codierten NullWWords richtig setzen --- 


btst #0,-1(al) ; Datenbit O von vorheriger Codierung = 1 ? 


beq.b sbcode_b1 

beIr #7,(a1) 

sbcode _b1: 

addq.w #4,al ; Al auf Syncwordanfang 
move.| #544894489,(al)+ ‚ SyncWords speichern 


;--- Infoblock in DO erstellen --- 


or.w #$ff00,dO ‚ DosFormat setzen 

swap dO ; Format/TrackNr. ins Hi-Word 
move.b d1,d0 ; Sektornummer 

Isl.w #8,d0 ‚ auf korekten Platz setzen 
move.b #11,d6 ; maximal 11 Sektoren 

sub.b d1,d6 1 - Sektornummer => 


move.b d6,dO 
bsr.w codelLong 


Anzahl Sektoren bis zur Lücke 
InfoLong codieren und speichern 


-- -.- -. - 
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;-- Füllbytes (32 codierte) => wichtig --- 


move.| #$aaaaaaaa,dO 
move.| dO,(al) 


;-- Bit 31 von ersten Codierten NullWords richtig setzen --- 


btst #0,-1(al) ; Datenbit O von vorheriger Codierung = 1 ? 


beg.b sbcode_b2 

beIr #7,(a1) 

sbcode_b2: 

adda.| #4,a1 

move.| dO,(al)+ ; restlichen 
move.| dO,(al)+ ; 28 Nullbytes 
move.| dO,(al)+ ; eintragen 


move.| dO,(al)+ 
move.| dO,(al)+ 
move.| dO,(al)+ 
move.| dO,(al)+ 


;--- Checksumme über Header erechnen (Blitter ist schneller) --- 


lea -40(a1),a2 ; ab Infoblock 


moveqg #0,d0 ; Checksummenspeicher 
moveg #9,d1 ‚40 Bytes (10 Longs) 


sbcode_check_loop: 

move.| (a2)+ ,d2 

eor.| d2,dO 

dbra d1,sbcode_check_loop 

and.| #$55555555,d0 

bsr.w codelong ; Checksumme codieren und speichern 
addq.w #8,a1 ; Al = Zeiger auf Ziel _Datenblock 
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;-- Einen Datenblock codieren mit dem Blitter --- 
-- AO = Quelle, Al = Ziel --- 


code daten: 

lea $dff000,a6 ; ChipBasis 

moveq #-1,d0 

move.| dO,$44(a6) ; First/LastMask 
moveq #0,d0 

move.| dO,-8(a1) ; Datachecksum = O 
move.| d0,$60(a6) ; MODULO OB = O0 
move.| dO,$64(a6) ; MODULO /D = O 
move.w #$5555,$70(a6) ; Maske für Quelle C 


ı 


;-- Gerade Datenbits paarweise ins Ziel kopieren --- 


lea 510(a0),a2 ; letztes Word von Quelle 


lea 1022(a1),a3 ; letztes Word von Ziel 
move.| a2,$4c(a6) ; B (Quelle+510) 


movem.| a2-a3,$50(46) ;A (Quelle+510), D (Ziel+ 1022) 
move.| #$1dd80002,$40(a6) ; BPLCONO UND BPLCON 1 
move.w #$0808,$58(a6) ; Size = 512 Bytes 

sbcode wait!: 

btst #14,$2(a6) 

bne.b sbcode wait] 


;-- ungerade Datenbits paarweise ins Ziel kopieren --- 


’ 


move.| a0,$4c(a6) ; B (Quelle) 
movem.| a0-a1,$50(a6) ; A (Quelle), D (Ziel) 
move.| #$1de40000, $40(a6) ; BPLCONO und BPLCON I 


move.w #$0808,$58(a6) ; BLTSIZE (512 Bytes) 
sbcode wait2: 

btst #14,$2(a6) 

bne.b sbcode wait2 


’ 
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;- Taktbits ins Ziel einfügen (für gerade + ungerade Bits) --- 


move.| a1,$50(a6) 


;A (Ziel) 
move.| a1,$4c(a6) ; B (Ziel) 
move.| a1,$54(a6) ; D (Ziel) 
move.w #$1d81,$40(a6) ; BPLCONO 


move.w #$1008,$58(a6) 


; BLTSIZE (1024 Bytes) 


sbcode_wait3: 
btst #14,$2(a6) 
bne.b sbcode wait3 


;-- Checksumme über Datenbereich berechnen --- 
j- Al = Quelle (Daten) --- 


moveg #-4,d0 

move.w d0,$62(a6) ; BLTBMOD = -4 
move.w d0,$66(a6) ; BLTDMOD = -4 
move.| a1,$50(a6) ; A (Quelle) 
subq.w #8, 

move.| a1,$4c(a6) ; B (Ziel) 

move.| a1,$54(a6) ; D (Ziel) 

move.w #$0dc3,$40(a6) ; BPLCONO 


move.w #%4002,$58(a6) 
sbcode_cwait: 

btst #14,$2(a6) 

bne.b sbcode_cwait 
move.| (a1),dO 

and.| #$55555555,dO 
bsr.b codelong 


;-- Bit 31 vom nachfolgenden codierten NullWord koregieren --- 


; BLTSIZE (256 * 4 Bytes) 


‚ erechnete Checksum holen 


; Prüfsumme in MFM und eintragen 


btst #0,1023(a1) 
bne.b sbcode 13 
bset #7,1024(a1) 
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sbcode_13: 

lea -64(al),al : Al wieder auf alten Wert setzen 
rts 

;--- ein Langword codieren in MFM-Format --- 

--- Al = Puffer, DO = Wert a 


Codelong: 


move.| dO,d2 

;-- ungerade Bits codieren --- 

Isr.| #1,d0O ; ungerade Bits ein nach rechts schieben 
or.| #$aaaaaaaa,dO ; Taktbits alle auf 1 

move.| dO,d1 ; Wert nach D1 kopieren 

ror.| #2,d1 ; Wert um zwei nach rechts rotieren 
or.| dO,dI ‚ ersten Wert mit 

not.| d1 ; zweiten NOR verknüpfen 

add.| d1,d1 ; Taktbits ein nach links schieben 

and.| #$55555555,d0O ; alle Taktbits wieder auf O 

or.| d1,dO ; Taktbits in ungeraden Datenbits eintr. 
bceir #31,d0 

btst #30,d0 ; ist Datenbit 30 = 1 ? 

bne.b code |1 ; dann, codierter Wert OK 

btst #0,-1(al) ‚ ist Bit O vom vorangegangenen Long = 1 ? 
bne.b code 11 ‚ dann, codierter Wert OK 

bset #31,d0 ;‚ sonst Taktbit 31 setzen 

code 11: 


move.| dO,(al)+ ; codierten Wert der ungeradene Bits eintragen 
;--- gerade Bits codieren --- 

or.| #faaaaaaaa,d2 

move.| d2,d1 

ror.| #2,d1 

or.| d2,d1 

not.| d1 

add.| d1,d1 ; Ist. #1,d1 

and.| #$55555555,d2 
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or.| d1,d2 
ber #31,d2 
btst #30,d2 
bne.b code _I2 
btst #0,-1(al) 
bne.b code _I2 
bset #31,d2 
code _I2: 
move.| d2,(al)+ 
bcir #7 (al) 
btst #6,(a1) 
bne.b code 13 
btst #0,-1(a1) 
bne.b code _|3 
bset #7 (al) 
code _13: 

rts 


Beschreibung des Listings: 


Als erstes wird der entsprechende Info-Block erstellt, der mit zwei 
codierten Nullbytes beginnt. Hierbei wird auch der obere "Rand" 
getestet, damit nicht mehr als drei O-Bits nebeneinander auftreten. 
Danach folgen zwei Sync-Markierungen. Jetzt wird das dazugehörige 
Info-Longword erstellt, codiert, getestet und eingetragen. Die 32 
codierten und getesteten Null-Bytes schließen den Info-Block ab. Nun 
kann die Prüfsumme über den Info-Block berechnet und eingetragen 
werden. 


Als nächstes wird der Datenblock über drei Blittervorgänge codiert. 
Dabei werden die geraden und ungeraden Datenbits getrennt 
codiert. Die codierten ungeraden Bits werden ab der Zieladresse und 
die codierten geraden Bits ab der Zieladresse +512 abgelegt. Wie die 
Blittervorgänge ablaufen zeigt Bild 2.c. Als letztes wird die 
Prüfsumme über den Datenblock berechnet (mit dem Blitter), codiert 
und eingetragen in den Info-Block. 
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Bild 2.c 


une Be 
BLICDAT=55555 
g Shirt Aelinke) orale BLICON-sae82 
PIIIELLLPPLLILE PUISIZE=50888 

B (Quelle+518) DixIo 








(8512 Bytes) 
C (CHaske) je 
D (Ziel+ti1822) pIpIpIp] C=8.B=1,.A=1 


u io Bit . in Ziel»uffer keri 
BLICDAT=555595 


(Shift l1Axrechts) en 
A (Quelle) ‚alo/x|p/x|pix|n|x|pix|o/x|pjx|p x DITSTZE-ZO00R 
SIT, BLISTZE= 
B (Quelle) D : 
D=-1, wenn 
C (kaske) C=1,B=1,A-1 
C=1,B-8,A-1 
C=8,B-1,A=1 
D (Ziel) C-8,B-1,A-8 


BLICONB8=S1D81 
3 (Shift Ixrechts) „nInIpIpIpfp[p[plpIpIplpIppIp]o! 
MEN SIRSSSRLSSISNINS  BLISIZE=51888 


B (Ziel) (1824 Bytes) 
D=1, wenn 
C (Haske) C=1,B=1,A-1 
C=-8,B=8,A-8 
DB (Ziel) 
Bild 2.c 
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Erklärung: 

0 = O-Bit 

1 = 1-Bit 

D = Datenbit 

1 = Taktbit 

x = Bitzustand egal 

d = Gegenteil vom Vorgänger D 

A bis D = Blitterkanäle (A bis C = Quellen, D = Ziel) 


Es werden immer nur die Blitterkanäle A, B und D eingeschaltet. Es 
wird aber trozdem auf den Kanal C zugegriffen, da wir dort (im 
BLTCDAT-Register) das Maskenwort eintragen. 


Achtung! - Wenn mit dem Blitter geshiftet (gescrollt) wird, so werden 
immer die dazugehörige Anzahl O-Bits am entgegengesetzten Ende 
eingefügt und am anderen Ende gehen entsprechend viele Bits 
verloren. 


Das Beispiel (Bild 2.c) zeigt das Codierverfahren nur anhand eines 
Longwords (4 Bytes). Möchte man mehr Longwords benutzen, so 
braucht man diese nur in der Mitte einzufügen, sonst bleibt alles 
gleich; in unserem Beipiellisting codieren wir ja 128 Longwords (512 
Bytes). 


Der Codiervorgang für das Unterprogramm Codelong() läuft nach 
dem gleichen Prinzip ab, wie die Codierung des Datenblocks. Nur 
werden die codierten Longwörter direkt hintereinander abgelegt und 
nicht in Abständen von 512 Bytes. 
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2.5 Track decodieren 


Das Decodieren eines Tracks ist erheblich einfacher zu program- 
mieren, als das Codieren. Denn schließlich brauchen wir nur die 
codierten ungeraden und geraden Longwords zu einem Longword 
wieder zusammenfügen. Dafür reicht ein einziger Blittervorgang aus. 


Das folgende Beispiellisting "DecodeBlock ()" decodiert einen 
codierten Datenblock und das Listing "Decodelong ()" decodiert zwei 
aufeinander folgende codierte Longwords wieder zu einem Long- 
word. 


Beschreibung der beiden Routinen: 


Routine: DecodeBlock (A1/A3) (Quelle, Ziel) 
Parameter: Al = Anfangsadresse des codierten Datenblocks 

(nach Infoblock; 1024 Bytes) 

A3 = Zieladresse, wo die decodierten Daten ab- 

gelegt werden sollen (512 Bytes groß) 
Rückgabe: keine 
Erklärung: 
Diese Funktion decodiert einen kompletten Datenblock (nur den Da- 
tenblock, nicht den Infoblock) 


Routine: Decodelong (AO) (Quelle) 

Parameter: AD =Anfangsadresse des codierten ersten Longwords. 
Rückgabe: in DO = decodiertes Longword 

Erklärung: 

Diese Funktion decodiert zwei aufeinander folgende Longwords zu 
einem. 


Das Decodierverfahren mit dem Blitter veranschaulicht Bild 2.d. 
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;-- Einen Datenblock decodieren a 
- Al = Zeiger auf Quelle, A3 = Zeiger auf Ziel -- 


Decodelock: 

lea $dff000,a6 ;Chipbasis 

moveqg #-1,d5 

move.| d5,$44(a6) ; First/LastMask (alle) 

moveq #0,d5 

move.| d5,$62(a6) ; Modulo B und A loeschen 

move.w d5,$66(a6) ; Modulo D loeschen 

move.w #$5555,$70(a6) ; Quelldatenregister Quelle C (Taktbits) 
lea 510(a1l),a ; Ende erste Haelfte (minus 1 Word) 
move.| a1,$50(a6) ; Quelle A (ungerade Bits) 

lea 512(a1),a1 ; Zeiger auf Ende zweite Haelfte 
move.| a1,$4c(a6) ; Quelle B (gerade Bits) 

lea 510(a3),a4 ; Ende vom Ziel (minus 1 Word) 
move.| a4,$54(a6) ; Ziel D (Bits wieder zusammen) 
move.| #$1dd80002,$40(a6) ; BLTCONO und BLTCON I 
move.w #$0808,$58(a6) ; Blitter starten 

Ib_wait: 

btst #14,$2(a6) ‚ auf Blitterende warten 

bne.b Ib_wait 

rts 


;-- Ein Longword decodieren ge 
;- AO = Zeiger auf codierte Longwords ---- 
i- => DO =decodiertes Longword - 


Beenden 
move.| (a0)+,dO ‚ungerade codierte Bits 
move.| (a0)+,d1 ;gerade codierte Bits 


and.| #55555555,d0 :Taktbits löschen 
and.! #$55555555,d1 :Taktbits löschen 


Ist. #1,dO ‚ungerade Bits ein nach links 
or.| d1,dO ;gerade Bits in ungerade Bits einfügen 
rts 
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Bild 2.d 


(Shift 1xlinks) 
(Quelle+518) 


(Quollo+1822) 





x[p/r[oIr [o[r[p/r|o[r/o[rIp]rp]Je! BPLCON8=5S1DDE 
ALL LLC LLC ILL ua uns 


(Zioel+518) DD] C-8,B=8,A-1 


= ungerade Datenbits 


€ 
A 
R 
C (CHaske) 
D 
A 
B = gerade Datenbits 


2.6 Diskregister 


Damit wir überhaupt mit dem Diskettenlaufwerk arbeiten können, 
sprich Daten darauf Speichern bzw. von dort Laden können, 
exestieren bestimmte Hardware-Register die uns dieses ermöglichen. 
Dabei handelt es sich um folgende Register: 


Name Adresse Funktion 

CIABPRB $BFD100 selektiert jeweiliges Laufwerk 

CIAAPRA $BFEOO1 gibt Auskunft über den Status der Diskette 
ADKCON $DFFOYE Disk-Kontrollregister schreiben 

ADKCONR $DFFO10 Disk-Kontrollregister lesen 

DSKPTH/L $DFFO2O Trackadresse 

DSKLEN $DFFO24 Dantenanzahl und Schreib/Lesemodus setzen 
DSKBYTR $DFFO1IA Datenbyte und Status lesen 

DSKSYNC $DFFO7ZE Synchronisationsmuster (WORD) 

DSKDAT $DFFO26 DISK-DMA-Datenwordpuffer 

DSKDATR $DFFOO8 Disk-Datenword lesen 
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Igt eine ausführli hreibung der einzelnen Register: 


CIABPRB - jeweiliges Laufwerk selektieren 


Mit diesem Register werden die Laufwerksmotoren der vier Laufwerke 
(0 bis 3) ein- oder ausgeschaltet, die Diskettenseite angewählt und 
der Schreib/Lese- Kopf bewegt. 


Bj 
7 DSKMOTOR 


DSKSEL3 
DSKSEL2 
DSKSELI 
DSKSELO 
DSKSIDE 


ndw2P10 


1 DSKDIREC 
0 DSKSTEP 


Funkti 
Kontrolliert die einzelnen Laufwerksmotoren. Ist das Bit 
= (0), wenn ein Laufwerk selektiert wird, so schaltet sich 
der Motor ein. Wenn ein Motor eingeschaltet wird, 
muß 500 milisek. oder auf "DSKRDY" gewartet 
werden, bevor Signale ans Laufwerk übermittelt 
werden können. 

Laufwerk 3 selektieren. Bit = O, dann selektiert 
Laufwerk 2 selektieren. Bit = O, dann selektiert 
Laufwerk 1 selektieren. Bit = O, dann selektiert 
Laufwerk O selektieren. Bit = 0, dann selektiert 
Diskettenseite anwählen, Bit = O0, dann obere Seite 
Bevor die Seite gewächselt wird, muß min. 1,3 ms ge- 
wartet werden. Bei gleicher Seite muß min. für 100 
microsek. das Signal anliegen 

Richtung des Schreib/Lesekopfs wählen. Bit = 0, 

dann nach Innen. 

Schreib/Lesekopf um eine Position bewegen. Bei einem 
Wechsel von High auf Low (1 auf 0) bewegt sich der 
Kopf. Zwischen einer Bewegung müssen min. 3 ms ver- 
gehen, bei einer Richtungsänderung min. 18 ms. 


Um ein oder mehrere Laufwerksmotoren einschalten zu können, muß 
erst das "DSKMOTOR"-Bit auf Null und danach das "DSKSELX" einmal 
auf Eins und dann wieder auf Null gesetzt werden. 
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Beispiel: Laufwerkmotor Null ein und obere Seite wählen: 


lea $bfd100,a0 ; CIABPRB-Adresse 
move.b #%01111101,(a0) ; alle DSKSELX Bits auf 1 
nop 

move.b #%01111001,(a0) ; Laufwerkmotor O = ein 


;—-- hier 500 millisek. warten ----- 


Um ein oder mehrere Laufwerksmotoren ausschalten zu können, muß 
erst das "DSKMOTOR"-Bit auf Eins und danach das "DSKSELX" einmal 
auf Eins und dann wieder auf Null gesetzt werden. 


Beispiel: Laufwerkmotor Null und Zwei ausschalten: 


lea $bfd100,a0 ; CIABPRB-Adresse 

move.b #%11111101,(a0) ‚ alle DSKSELX Bits auf 1 
nop 

move.b #%11010101,(a0) ; Laufwerkmotor 0/2 = aus 


---- hier 500 millisek. warten ----- 


Das "DSKSTEP"-Bit sollte bei jedem Signalwechsel von High auf Low 
immer wieder auf High (1) gesetzt werden, um bei Laufwerkswechsel 
Probleme zu vermeiden. 


CIAAPRA - Statusregister des jeweiligen Laufwerks 
Dieses Register gibt Auskunft über verschiedene Zustände des 


Laufwerks, zum Beispiel ob eine Diskette im Laufwerk, diese 
schreibgeschützt ist usw. 
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Bit Name Funkti 
5 DSKRDY Ob Laufwerwerk volle Geschwindigkteit erreicht hat 


und somit bereit ist, Befehle entgegenzunehmen. 
(Bit = 0, dann OK) 

4 DSKTRACKO Schreib/Lesekopf auf Position Null, wenn Bit = O 

3 DSKPROT Ob Diskette schreibgeschützt ist, Bit = O dann ja 

2 DSKCHANGE Ob sich im Laufwerk eine Diskette befindet? 
Bit = 1, dann Diskette im Laufwerk 
Bei Bewegung des Schreib/Lesekopfs wird dieses Bit 
aktualisiert. 


Die Bits beziehen sich immer auf das aktuell angewählte Laufwerk. 
Sollten mehrere Laufwerke gleichzeitig angewählt sein, so werden die 
Bits den Ereignissen entsprechend gesetzt. Zum Beispiel wird das Bit 
"DSKTRACKO" = 0, wenn die Position eines der Schreib/Leseköpfe 
sich auf Track Null befindet. 


ADKCON/R - DMA-Kontrollregister lesen/schreiben 


Dieses Register ist das wichtigste des Disk-Controllers. Hier werden 
die wichtigsten Bits gesetzt, die für den Datentransfer erforderlich 
sind. In dem ADKCON-Register können nur die Bits gesetzt und im 
ADKCONR nur gelesen werden. 


Bit Name Funktion 
15 CLR/SET Controllbit für folgende Bits 
14 PRECoMPI Schreibdichte - oberes Bit 
13 PRECOMP2 Schreibdichte - unteres Bit 
Precompwert Schreibdichte 
00 00 nanosekunden 
01 140 nanosekunden 
10 280 nanosekunden 
11 560 nanosekunden 
12 MFMPREC Kodierformat: Bit = O0, dann GCR, Bit = 1, dann MFM 
11 UARTBRK für Disk unwichtig - keine Funktion 


10 WORDSYNC Synchronisation einschalten. Bit = 1, dann ein. 
Das Syncword muß im Register "DSKSYNC" stehen. Der 
Transfer beginnt erst nach Auffinden des Syncwords. 

9 MSBSYNC GCR-Synchronisation einschalten. Bit = 1, dann ein 
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8 FAST Schreibgeschwindigkeit wählen 
Bit = 1, dann 2 millisekunden für MFM-Kodierung 
Bit = 0, dann 4 millisekunden für GCR-Kodierung 
7-0 Audio unwichtig für Disk-Controller (für Audioausgabe) 


Das CLR/SET-Bit dient quasi als Hauptschalter für alle anderen Bits in 
diesem Register. Ist dieses Bit gesetzt, so werden alle Bits die auch 
gesetzt sind, gesetzt, ist es hingegen Null, so werden alle Bits die 
gesetzt sind, gelöscht. 


DSKPTH/L - DMA-Trackadresse 

Hier steht die Anfangsadresse eines Puffer, mit dem der Datentransfer 
durchgeführt werden soll, also wohin die Diskdaten geladen bzw. von 
dem sie gelesen werden sollen. Die Adresse kann man mit einem 


Befehl setzen. 


zum Beispiel: 
move.| #puffer,$DFFO2O 


puffer: bIk.b 15000,0 


DSKLEN - Datenlänge und Schreib/Lesemodus setzen 


Hier können wir die Anzahl Words (16 Bit) einstellen, die transferiert 
und ob diese Daten von Diskette gelesen oder auf Diskette 
geschrieben werden sollen. 


Bit_Name Funktion 
15 DMAEN Disk-DMA-Transfer ermöglichen, Bit = 1, dann ja 
14 WRITE Schreib/Lesestatus 


Bit = 1, dann Daten auf Diskette schreiben 
Bit = O0, dann Daten von Diskette lesen 
13-0 LENGHT Anzahl der zu transferierenden Datenwords 
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Für das fehlerfreie Starten des Disk-DMA-Transfers muß man das 
Register zweimal mit dem gleichen Wert beschreiben und dieser 
Vorgang wird folgenderweise programmiert: 


1. Register auf den Wert $4000 setzen (DMA sperren) 

2. gewünschten Wert ins Register schreiben 

3. gleichen Wert nochmal ins Register schreiben um DMA-Transfer 
zu Stärten 

4. Punkt 1 durchführen um das Schreiben auf Disk zu verhindern 


Während der Datenübertragung wird das "DSKPTX"- Register immer 
um 1 Word (2 Bytes) raufgezählt und das "DSKLEN"-Register bis auf 
Null heruntergezählt. 


Achtung! Wegen eines Hardwarefehlers werden die letzten drei Bits 
des letzten Words nicht auf Diskette geschrieben und umgekehrt wird 
das letzte Word nicht in den Speicher geladen. Deswegen sollte 
immer ein Word mehr übertragen werden. 


DSKBYTR - Datenbyte und Status lesen 


Über das Register kann man den DMA-Transfer ein wenig kontrol- 
lieren oder vielmehr verfolgen. 


Bi Funkti 

15 DSKBYT Bit = 1, dann Byte von Diskette empfangen. Wird 
bei einem Lesezugriff gelöscht. 

14 DMAON Bit = 1, dann ist DISK-DMA-Transfer möglich. Es 


müssen die Bits DMAEN im DSKLEN-Reg. und die Bits 
DSKEN und DMAEN im DMACON-Reg. gesetzt sein. 
13 DISKWRITE zeigt Schreib/Lesemodus an, Bit = O, dann lesen 
12 WORDEQUAL Bit = 1, wenn Syncword gefunden, wird ca. 2 mili- 
sekunden angezeigt. 


11-8 für spätere Erweiterungen freigehalten. Diese Bits 
dürfen nicht von Ihnen gesetzt werden. 
7-0 DATA enthält das gerade von Disk gelesene Byte 
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DSKSYNC - Synchronisationsword setzen 


In dieses Register kann das Syncword gespeichert werden, ab dem 
der Disk-Controller die Datenübertragung starten soll, wenn das 
WORDSYNC-Bit im ADKCON-Register gesetzt ist. Es wird dann so- 
lange mit der Datenübertragung gewartet, bis das Syncword auf 
Diskette gefunden wurde. Überlicherweise wird hier der Wert $4489 
eingetragen, denn das ist der "normale" DOS-Wert. 


Beispie/ zum speichern des SyncwordS: 


move.w #$4489,$DFFO7E ; Syncword setzen 


DSKDATI/R - Disk-DMA-Datentransferword setzen/schreiben 


Dieses Register dient als Datenpuffer bei der Datenübertragung über 
den Disk-DMA. Hierüber könnte man Daten auch ohne DMA lesen 
und speichern. 


Als letztes fehlt uns noch die Information, wie wir testen können ob 
ein Laufwerk angeschlossen ist oder nicht. Dafür gibt es einen 
speziellen Identifikationsmodus. Dabei wird ein serielles 32-Bit langes 
Datenlongword vom gewünschten Laufwerk gelesen. Dazu selektieren 
wir die Leitung des gewünschten Laufwerkmotors wie oben be- 
schrieben (Motor einmal ein und danach wieder aus), wodurch das 
serielle Schieberegister zurückgesetzt wird. Danach lesen wir 32 mal 
das "DSKRDY"-Bit vom Register "CIAAPRA" aus, indem wir das 
"DSKSELX"-Bit auf Low setzen, dann das "DSKRDY"-Bit lesen und das 
"DSKSELX"-Bit wieder auf High setzen. Das erste Bit ist dabei das 
höchste Bit des Longwords. 
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Folgende Longwords sind festgelegt: 


$00000000 Kein Laufwerk angeschlossen 
$FFFFFFFF Standart Amiga 3.5 Zoll-Laufwerk 
$55555555 Standart 5.25 Zoll-Laufwerk 


Jetzt folgen noch ein paar Beispiellistings, welche demonstrieren, wie 
die oben beschriebenen Register programmiert werden. Diese Listings 
finden Sie natürlich auch auf der beiliegenden Diskette. 


Routinenliste 
DisksystemOn () = neues Diskettensystem init. 
DO => 0, dann Ok/ -1 = Error 
DisksystemOff ) = neues Diskettensystem aus 


MotorAn (I drive) Motor einschalten (0 bis 3) 
DO => DO, dann Ok/ -1 = Error 
MotorAus () Motor ausschalten 


DriveOn (I drive) = Testen ob Laufwerk angeschlossen 


DO => 0, dann OK/ -1 = Error 
TrackNull () = Schreib/Lesekopf auf Track Null fahren 


DO => 0, dann OK/ -1 = Error 
Trackposition (DO) = Kopf auf Track X fahren (0 bis 159) 

DO => 0, dann OK/ -1 = Error 
WaitTime (D1) = Zeitschleife (1 = 64 microsekunden) 


kim Neue Diskroutinen initialisieren 
- DO => 0, dann Ok/ -1 = Error 


nn nn nn nn nn nnmumme 


tst.w disksystem ; Disksystem schon init. ? 
bne.w initdisksystem_end ; wenn ja, dann ende 
move.| 4,36 

move.| #14000+(3*512),d0 ; Tracklänge 

move. #$10003,d1 ; Chip + Public Speicher 
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jsr -198(a6) ; und reservieren 

move.| dO,I mfmcode ; Trackadresse speichern 
bne.b disksystemon_] ; überhaupt vorhanden ? 
disksystemon_error: 

moveq #-1,d0 

rts 

disksystemon_1: 

move.| dO,d!1 

add.i #14000,d1 ; Fileblockadresse ermitteln 
move.| d1,f fileblock ; und speichern 

add.! #512,d1 ; Datablockadresse ermitteln 
move. d1,f_datablock ; und speichern 

add.! #512,d1 ; Diskblockadresse ermitteln 
move.| d1,f_diskbitmap ; und speichern 

move.| dO,a0 ; Trackadresse nach AO 
moveq #100,d0 

move.| #$aaaaaaaa,dI 

disksystemon_loop: ; ab hier Tracklücke erzeugen 
move.| d1,(a0)+ 

move.| d1,(a0)+ 

move.| d1,(a0)+ 

move.| d1,(a0)+ 


move.| d1,(a0)+ 

dbra dO,disksystemon_loop 
lea oldtracktable,a5 ; ab hier Parameter init. 
lea tracktable,a6 

move.w #0,l drive 

moveq #-1,d0 

move.| dO,(a5) 

move.| dO,(a6) 

move.| dO,4(a5) 

move.| dO,4(a6) 

move.w #1,disksystem 
move.w dO,tracknummer 
initdisksystem_end: 

moveq #0,d0 

rts 


;--- Neue Diskroutinen wieder freigeben --- 


DiskSystem Off: 


cmp.w #1,disksystem ‚ Disksystem schon init. ? 
bne.w disksystemoff end ; wenn ja, dann ende 
move.| 4,36 

move.| #14000+(3*512),dO ; Tracklänge 

move.| | mfmcode,al ; Trackadresse 
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movem.| d1-d2/a0,-(sp) 
move.w | _drive,d2 

add.w d2,d2 

lea tracktable,a0 

move.w tracknummer,(a0,d2.w) 
bsr.b motor_aus 

movem.l (sp)+ ‚d1-d2/a0 

rts 


;-- ab hier Motor deselektieren und ausschalten --- 
motor aus: 

lea drivetable,a0 

move.w (a0,d2.w),dO 


or.b dO,$bfd100 ‚ Laufwerk deselektieren 
move.w #$80,d1 

or.b d1,$bfd100 ‚ Motor-Bit selektieren 
not dO 

and.b dO,$bfd100 ‚ Motor ausschalten 

not dO 

or.b dO,$bfd100 ;, Drives deselektieren 


bra.b motor_wait 


;- testen ob Laufwerk angeschlossen 
| drive = Drive (0,1,2,3) u 
j- => DO = 0, dann OK, -1 = Error 


DriveOn: 

movem.| d7/a0,-(sp) 

moveq #0,d0 

move.w | _drive,d? 

beq.b driveon end ; Drive O auslassen (weil Intern) 
addq.w #3,d7 

lea $bfd100,a0 ; CIABPRB-Adresse 
bcir d7,(a0) ‚ DSKSELX = Low 
bset d7,(a0) ;‚ DSKSELX = High 
ber d7,(a0) ; DSKSELX = Low 
move.b $bfe001,d0 ; DSKRDY lesen 
bset d7,(a0) ; DSKSELX = High 
and.w #32,d0 ; DSKRDY = O0 ? 
beq.b driveon end ; wenn ja, dann OK 
moveq #-1,d0 ; sonst Error 
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driveon end: 
movem.| (sp)+ ‚d7/a0 
rts 


;-- Position vom LeseKopf auf Track Null bewegen 
;--- Rueckgabe: DO = Old Trackposition oder -1 = Error --- 


TrackNull: 

moveq #0,d0 

lea $bfe001,a0 ; CIAAPRA-Adresse 

lea $bfd100,a1 ; CIABPRB-Adresse 
no_trackO: 

btst #4,(a0) ; DSKTACKO (Drive-Status) 


beq.b trackO_end 

bset #1,(al) 

nop 

belr #0,(a1) 

nop 

bset #0,(a1) 

nop 

move.| #50,d1 ; ca. 3 Millisekunden 
bsr.w waittime ; warten 
move.w #40000,d7 
trackO_ready_ wait: 

btst #5,(a0) 

beq.b trackO_ready 

moveq #2,d1 

bsr.w waittime 

sub.w #1,d7 

bne.b trackO ready wait 

moveq #-1,d0 

move.w I drive,d7 

add.w d7,d7 

lea oldtracktable,a0 

move.w dO,(a0,d7.w) 

rts 

trackO_ready: 

addq.w #1,d0 

bra.b no_trackO 

trackO_end: 

add.w dO,dO ; Track mal 2 
btst #2,(a1) 

beq.b trackO_1 

addq.w #1,d0 

trackO_1: 

bset #2,(al) 

bset #0,(a1) 

move.| #25,d1 ‚ ca. 1.5 Millisekunden 


Seite 250 


Das Amiga-Di nfo 


bsr.w waittime ; warten 

clr.w tracknummer 

move.w | drive,d? 

add.w d7,d7 

lea tracktable,a0 

clr.w (a0,d7.w) ; Trackpos 

lea oldtracktable,a0 

move.w d0,(a0,d7.w) ; alte Trackposition retten 
rts 


;--- Lesekopf auf Position Track X -- 

;—- DO = Tracknummer 0-159 _ 

— => DO = 0, dann Ok; -1 = Fehler -- 
TrackPosition: 

cmp.w #159,d0 ; Tracknummer > 159 ? 
bls.b tp1 
trackposition_error: 

moveq #-1,d0 

rts 
tpl: 

lea tracknummer, a0 

lea $bfd100,a1 

move.w (a0),d4 

bmi.b trackposition_error 

move.w dO,d1 ; Tracknummer nach D1 
beir #2,(a1) 

and.w #1,d1 

bne.b trackpos_ungerade 

bset #2,(a]) 

trackpos_ungerade: 

move.| #25,d1 ; ca. 1.5 Millisekunden 
bsr.w waittime ; warten 

move.w dO,(a0) 

Isr.w #1,d4 ; D4 
Isr.w #1,d0 ; DO 
cmp.w d4,dO 

beq.b trackposition_end 

cmp.w d4,dO 

bmi.b trackpos_aussen 

sub.w d4,dO 

subqg.w #1,d0 

belr #1,(a1) 

trackpos_start: 

move.| #290,d1 ; ca. 18 Millisekunden 
bsr.w waittime ; warten 


’ 


OLD-RealTrack-Nr. 
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trackpos_loop: 

beIr #0,(a1) 

nop 

bset #0,(a1) 

nop 
move.| #50,d1 

bsr.w waittime 
move.w #40000,d7 
trackpos_ready_ wait: 
btst #5,$bfe001 
beq.b trackpos_ ready 
moveq #2,d1 

bsr.w waittime 

sub.w #1,d7 

bne.b trackpos_ ready _ wait 
moveq #-1,d0 

rts 

trackpos_ready: 

dbra dO,trackpos_loop 
trackposition end: 
moveqg #0,d0 

rts 


trackpos_ aussen: 
sub.w dO,d4 
subq.w #1,d4 
move.w d4,dO 

bset #1,(al) 

bra.b trackpos start 


- Zeitschleife - 
;- D1 = loop (1 ca. 64 microsec.) --- 
WaitTime: 
move.| d2,-(sp) 
waittime_next: 
move.b $dff006,d2 
waittime loop: 
cmp.b $dff006,d2 
beq.b waittime loop 
sub.| #1,d1 
bne.b waittime next 
move. (sp)+ ,d2 
rts 
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Es folgt jetzt noch ein kleines Beispiellisting, das den Umgang mit 
den Routinen demonstriert. Darin wird der Motor von Laufwerk O 
eingeschaltet, der Schreib-/Lesekopf auf Track 80 (Roottrack) gefahren 
und dann der Motor wieder ausgeschaltet. Bei Betätigung der linken 
Maustaste wird der Schreib-/Lesekopf wieder auf die alte Position 
bewegt und das Programm beendet. 


move.| 4,36 ‚, execbase 
jsr -120(a6) ; Interrupts verbieten 
move.w $dff010,dO ‚ alter ADKCON Wert 
bset #15,d0 ; SET/CLR-Bit setzen 
move.w dO,old_adkcon ; und retten 
bsr disksystemon ‚ neues DiskSystem ein 
tst.| dO ‚ erfolgreich ? 
bne exit ; wenn nicht, dann ende 
move.w #0,|_drive ; Laufwerk O ansprechen 
bsr motoran ; Motor einschalten 
tst.| dO ; erfolgreich 
bne exit ; wenn nicht, dann ende 
move.w #80,d0 ; Track 80 
bsr trackposition ; Kopf bewegen 
bsr motoraus ; Motor wieder aus 
wait: 
btst #6, $bfe00 1 ; linke Maustaste abfragen 
bne wait 
exit: 
bsr disksystemoff 
move.w #$7f00,$dff09e ‚ alten ADKCON 
move.w old adkcon,$dff09e ; Wert setzen 
move.| 4,36 
jisr -126(a6) ; Interrupts erlauben 
rts ; Programm beenden 


old adkcon: dc.w 0 
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2.7 einen Track laden 


Mit dem bisherigen Wissen und Routinen können wir zwar den 
Motor ein/ausschalten und den Schreib-/Lesekopf bewegen, aber 
Daten von der Diskette laden können wir immer noch nicht, obwohl 
die nötigen Informationen dazu bereits besprochen wurden. 
Deswegen folgt hier jetzt eine Funktion, mit der ein ganzer Track 
kodiert in den Speicher geladen werden kann. 


Routine: ReadMFMTrack (DO) (Tracknummer) 
Parameter: DO =Nummer des Tracks, welcher geladen werden soll 
Rückgabe: => DO = codierte Trackadresse/ oder O0, wenn Fehler 
Erklärung: Diese Funktion lädt einen kodierten Track in das RAM. 
Zuvor muß natürlich der Motor eingeschaltet werden. Der 
Track hat dabei folgenden Aufbau: 
erst kommen 1664 Bytes mit der Tracklücke, dann 11 x 
1088 Bytes für die Sektoren und zuletzt folgen zwei 
Bytes, wegen dem Hardwarefehler. 


Achtung! - Da die Sektoren nicht geordnet nebeneinander im 
Speicher liegen, werden die Anfangsadressen in einer Tabelle ge- 
speichert (sektoradressen: bik.| 11,0). 


Beispiellisting um auf die Sektoradressen zugreifen zu können: 


jinene Sektornummer muß in DO stehen (0 bis 10) ----- 
lea sektoradressen,aO ; Sektortabelle 


add.w dO,dO ; Sektornummer mal 
add.w dO,dO ; vier, wegen Tabelle 
move.| (a0,dO.w),dO ; Sektoradresse nach DO 
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;—- MFM-Track in Speicher laden 


-— DO = Tracknummer 


nfor 


= => DO = 0, dann Error, sonst Trackadresse -- 


ReadMFMTrack: 

bsr.w trackposition 

tst.| dO 

bmi.w rmt_e] 

move.w #6,fehler 

lea $dff000,a2 
readmfm: 

move,| I mfmcode,a6 
lea 1664(a6),a6 

move.| a6,5 

move.| #$aaaaaaaa,(a6) + 
move.w #%4489,(a6) + 
move.w #$4000,$24(a2) 
move.w #2,$9c(a2) 
move.w #$8210,$96(a2) 
move.w #%7f00,$9e(a2) 
move.w #$8500,$9e(a2) 
move.w #$4489,$7e(a2) 
move.| a6,$20(a2) 
move.w #$8024,d0 
move.w d0,$24(a2) 
move.w d0,$24(a2) 
move.w #40000,d6 
rmt_b1: 

move.w $1e(a2),dO 

btst #1,d0 

bne.b rmt_b2 

moveq #3,d1 

bsr.w waittime 

dbra d6,rmt_b1 

move,w #$7fff,$9c(a2) 
move,.w #$4000,$24(a2) 
bra.b rmt_error 

rmt_b2: 

move.w #$7fff,$9c(a2) 
move,w #$4000,$24(a2) 
lea 8(a5),a0 

moveqg #9,d1 

bsr.w pruefsumme 
Re, dO,d3 
lea$48(a5),a0 

bsr.w decodelong 

cmp.| dO,d3 

bne.b rmt_error 

lea 8(a5),a0 


; Kopf positionieren 


; 6 Fehlversuche 
; Chipbasisadresse 


;‚ Trackadresse 
‚ nach Tracklücke 


; geht bei Auffinden vom Syncword 
; verloren 

; DMA sperren 

; Disk-IRQ erlauben 

; DiskDMA erlauben 

‚ Bits löschen 

; ADKCON mit richtigem Wert laden 
; Syncword 

; Datenzielpuffer 

;‚ 72 Bytes lesen 

; Daten von 

; Disk lesen 


; IRQs auslesen 

; Disk-IRQ lesen 

; Daten schon alle gelesen ? 

; wenn nicht, dann gewisse Zeit 

; warten 

; weiter warten bis Daten gelesen 
; IRQs verbieten 

; Disk-DMA sperren 


;IRQs verbieten 

; Disk-DMA sperren 

; InfoBlockadr. 

; 10-1 Longs 

; Summe über Header berechnen 
; Summe retten 

: Blockheader-Checksummenadr. 
; Headersummen vergleichen 

; Headersummen vergleichen 

; wenn ungleich, dann von vorn 
; Headeradr. 
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bsr.w decodelong ; Header (Infoblock) decodieren 
move.w dO,d3 ; Header (Infoblock) nach D3 
and.w #$00ff,d3 ; Sektoren bis Lücke ausmaskieren 
cmp.w #12,d3 ; kleiner 12 ? 

bcs.b rmt_ok ‚ dann OK 

rmt_error: ; sonst Fehler 

subq.w #1,fehler ; Anzahl Fehlversuche -1 
bne.w readmfm ; > 0, dann von vorn 

move.w tracknummer,dO ; sonst Tracknummer holen 
move.w dO,-(sp) ; und retten 

bsr.w tracknull ; Kopf auf Position Null fahren 
move.w (sp)+ ‚di ; Tracknummer wieder holen 
tst.| dO 

bmi.b rmt_el 

move.w d1,dO ; Tracknummer 

bsr.w trackposition ; Kopf neu positionieren 
rmt_el: 

moveq #0,d0 

rts ; Ende 

rmt_ok: 

subq.w #1,d3 ; Anzahl der Blöcke bis Lücke 


move.w d3,d2 
moveqg #11,d4 


sub.w d2,d4 ; Anzahl der Blöcke nach Lücke 
mulu #1088,d3 ; D3 = Anzahl der Bytes bis Lücke 
mulu #1088,d4 ; D4 = Anzahl der Bytes nach Lücke 


move.w d3,bytesvluecke 

move.w d4,bytesnluecke 

;-- ab hier Daten vor und nach Lücke einlesen --- 
move.| a5,firstblockadr 

;-- Blockanfänge löschen -- 

move.| a5,a0 

lea sektoradressen,a3 

moveqg #10,d1 ; 11 Sektoren 
moveq #0,d0 

rmt_cl!: 

move.| d0,1088(a0) 

move.| dO,(a3)+ 

lea 1088(a0),a0 

dbra d1,rmt_cl 

cIr.w sektorzaehler 


move.w bytesvluecke,d2 ; Anzahl Bytes vor Lücke 

beq.b rmt_1 

bsr.b readmfmbytes ; Bytes vor Lücke lesen + checken 
tst.!| dO 


bmi.b rmt_error 
move.w bytesvluecke,dO 
lea (a5,dO.w),a6 ;‚ Datenadr. für Bytes nach Lücke 
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move.| #$aaaaaaaa,(a6) + 

move.w #%4489,(a6) + 

„rmt_1: 

move.w bytesnluecke,d2 ; Anzahl Bytes nach Lücke 
beqg.b rmt_2 

bsr.b readmfmbytes ; Bytes nach Lücke lesen + checken 
tst.| dO 

bmi.w rmt_error 

rmt_2: 

bsr.b sektor_check ; letzten Block prüfen 

tst.! dO 

bne.w rmt error 

move.w #$aaa8, $2ec0(a5) ; Endmakierung nach Track 
btst #0,$2ebf(a5) 

beq.b rmt end 

move.w #$2aa8,$2ec0(a5) 


rmt_end: 
move.| I mfmcode,dO ; kodierte Trackadresse nach DO 


rts ; und Ende 
j- Bytes lesen und überprüfen + Infoblock neu erstellen -- 
ReadMfmBpytes: 
move.w #$4000,$24(a2) 
move.w #2,$9c(a2) 
move.| a6,$20(a2) 
move.w d2,dO 
Isr.w #1,dO 
addq.w #1,d0 
or.w #%8000,d0 
move.w d0,$24(a2) 
move.w d0,$24(a2) 
bsr.b sektor_check 
move.w #$7fff,$9c(a2) 
move.w #$4000,$24(a2) 
rts 
;—- Sektoren überprüfen -— 
sektor_check: 
move.l firstblockadr ‚a3 
lea sektoradressen,a4 

0: 


cmp.w #11,sektorzaehler 

beq.w bc_end 

bc_wait: 

move.w $1e(a2),dO ; schon Diskdaten alle gelesen ? 
btst #1,dO 

bne.w bc_end 

tst.|l 1088(a3) 

beq.b bc_wait 
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;— ab hier Blockdaten überprüfen --- 


lea 64(a3),a0 

move.w #255,d1 

bsr.w pruefsumme 
move.| dO,d3 

lea 56(a3),a0 

bsr.w decodelong 
cmp.| dO,d3 

bne.w bc_error 

lea 8(a3),a0 

moveq #9,d1 

bsr.w pruefsumme 
move.| dO,d3 

lea 48(a3),a0 

bsr.w decodelong 
cmp.| dO,d3 

bne.w bc_error 

lea 8(a3),a0 

bsr.w decodelong 
move.w dO,d7 

Isr.w #8,d7 

and.w #$ff,d7 

swap dO 

move.w tracknummer,d1 
or.w #$ff00,d1 

cmp.w d1,d0 

bne.b bc_error 

move.| #$aaaaaaaa,(a}) 
btst #0,-1(a3) 

beg.b bc_2 

move.| #$2aaaaaaa,(a3) 
bc_2: 

move.| #544894489,4(a3) 
move.w d1,dO 

swap dO 

move.w d7,dO 

Isl.w #8,dO 

move.b #11,d0 

sub.b sektorzaehler + 1,d0 
lea 8(a3),al 

bsr.w codelong 

lea 8(a3),a0 

moveq #9,d1 

bsr.b pruefsumme 

lea 48(a3),al 

bsr.w codelong 

add.w d7,d7 

add.w d7,d7 


; Datenblockadr. 

; 256-1 Longs 

; Prüfsumme über Datenblock bilden 
; Datenprüfsumme retten 


; Zeiger auf Datensumme von Disk 
; decodieren 
; Datensummen vergleichen 


me u. 


Headeranfang 
10-1 Longs 


; Headerprüfsumme retten 
; Zeiger auf Headersumme von Disk 


-. 


decodieren 
Headersummen vergleichen 


; Zeiger auf Header (Infoblock) 
; Infoblock decodieren 


D7 = Sektornummer 


;‚ Track OK ? 


Nullbytes 


‚ Syncwords 
; Format/Track 


; Sectornummer 


; neuer Infoblock 


Infoblock neu eintragen 


‚ 10-1 Longs 
; neue Headerprüfsumme berechnen 
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tst.| (a4,d7.w) ; Sektor schon eingetragen ? 
bne.b bc_error 
move.| a3,(a4,d7.w) ; Sektoradresse eintragen 


lea 1088(a3),a3 

addq.w #1,sektorzaehler 

bra.w bc_O 
bc_end: 

moveqg #0,d0 

move.| a3,firstblockadr 

rts 
bc_error: 

moveq #-1,d0 

rts 

;-— zwei codierte Longwords zu einem decodieren --—- 
Decodelong: 

move.| (a0) +,dO 

move.| (a0) + ,d1 

and.| #$55555555,dO 

and.! #$55555555,d1 

Isl.I #1,dO 

or.| d1,dO ; DO = Decodierte Headersumme 
rts 


;-- Prüfsumme ermitteln . 
;-- D1 = Anzahl Longs-1, AD = Datenanfang . 
— => DO = Prüfsumme - 
Pruefsumme: 

moveq #0,d0 

ps1: 

move.| (a0)+,d2 

eor.| d2,dO 

dbra d1,ps1 

and.| #$55555555,d0 

rts 


bytesvluecke: dc.w O 
bytesnluecke: dc.w O 
firstblockadr: dc.! O 
sektoradressen: bik.| 11,0 
sektorzaehler: dc.w O 
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2.7.1 einen Track abspeichern 


Für das Abspeichern eines kodierten Tracks ist die Funktion 
"WriteMFMTrack ()" zuständig, die wie folgt zu bedienen ist: 


Routine:  WVriteMFMfTrack (DO) (Tracknummer) 

Parameter: DO = Nr. des Tracks, welcher gespeichert werden soll 
Rückgabe: => DO = Trackadresse oder O0, wenn Error aufgetreten 
Erklärung: 

Diese Funktion speichert einen kodierten Track auf Diskette. Dabei ist 
zu beachten, daß die Tracknummer auch mit dem sich im Speicher 
befindenem Track übereinstimmt. Am besten erst mit ReadMFMTrack 
in den Speicher laden, dann manipulieren und mit dieser Funktion 
wieder auf Diskette speichern. 


;-- Einen Track im MFM-Format auf Disk speichern 
;- DO = Tracknummer (0-159) 
;- => DO = Trackadresse, dann OK; O0 = Error 


WriteMFMTrack: 

bsr.w trackposition ; Kopf positionieren 

tst.| dO 

bmi.w wmt_error 

lea $dff000,a6 ; Chipbasisadresse 

move.w #$4000,$24(a6) ; Disk-DMA verbieten 

move.w #2,$9c(a6) ; Disk-IRQ erlauben 

move.| I mfmcode,a0 ; Trackadresse 

move.| a0,$20(a6) ; nach DSKPTX 

move.w #%0,$7e(a6) ; kein Syncword 

move.w #%8210,$96(a6) ; DiskDMA erlauben 

move.w #$7f00,$9e(a6) ; ADKCON löschen 

move.w #$8100,$9e(a6) ; dann setzen 

cmp.w #80 ,tracknummer ; Tracknummer > 80 ? 

bcs.b wmt sb] ; wenn nicht, dann sb1 
move.w #$a000, $9e(a6) ‚ sonst Schreibdichte ändern 
wmt sb1: 

move.w #$daa1,dO ; Länge = 6817 Words 
move.w d0,$24(a6) ; ((11*1088)+ 1664 +2)/2 = 6817 Words 
move.w dO,$24(a6) ; Daten jetzt auf Disk schreiben 


move.w #40000,d6 
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wmt_ready: 

btst #1,$ 1f(a6) 

bne.b wmt_r 

moveqg #3,d1 

bsr.w waittime 

dbra d6,wmt ready 
moveq #-1,d0 

bra.b wmt_rl 

wmit_r: 

moveq #0,d0 
wmt_r]: 

move.w #$7fff,$9c(a6) 
move.w #$4000,$24(a6) 
move. dO,d1 

move. I mfmcode,dO 
tst.| d1 

beq.b wmt_ end 
wmt_error: 

moveq #0,d0 
wmt_end: 

rts 


for 


; warten bis alle Daten 
; auf Disk gespeichert 


‚ weiter warten 


; DISKIRQ löschen 
; Disk-DMA verbieten 


‚ Trackadresse 

; Fehler ? 

‚ wenn nicht, dann Ende 
‚ sonst Error 


2.8 einen Block laden/abspeichern 


Mit den bisherigen Routinen können wir Daten nur kodiert von 
Diskette laden bzw. darauf speichern. Es fehlen uns noch Funktionen, 
mit denen wir die Informationen dekodieren bzw. kodieren können. 
Da es nicht sinnvoll ist, immer einen ganzen Track auf einmal zu de- 
/kodieren, kann mit den nachfolgenden Funktionen immer nur ein 
Block dekodiert oder kodiert werden. Das bringt eine erhebliche 
Zeitersparnis und verbraucht weniger Speicher. Doch nun zu den 


Funktionen: 


Seite 261 


Das Amiga-Diskettenformat Kapitel 2 


Routine: LoadBlock (D0,D1,D2) (Blocknr.,Mode,Blockadresse) 
Parameter: DO = Nummer des Blocks, welcher geladen werden soll 
(Blocknummer von O bis 1759) 
D1 = wie der Block behandelt werden soll, folgende Bits 
können dafür gesetzt werden: 
Bit_Funktion 
0 Block vom Track im RAM laden 
1 Block neu von Disk laden 
2  Block-Checksumme (Offet 20) testen (s. Kapitel 3) 
3 alten Track bei Trackwechsel vorher auf Disk speichern 
D2 = Adresse eines Puffers von 512 Bytes, wo der Block 
hin dekodiert werden soll 
Rückgabe: => DO = Blockadresse oder 0, wenn Error aufgetreten 
Erklärung: 
Diese Funktion lädt einen Block zwischen O und 1759 in den Speicher 
und dekodiert diesen in den Puffer, welche Adresse im Datenregister 
D2 übergeben wurde. 
Routine:  SaveBlock (DO,D1,D2) (Blocknr.,Mode,Blockadresse) 
Parameter: DO = Nummer des Blocks, welcher gespeichert werden 
soll (Blocknummer von O bis 1759) 
D1 = wie der Block behandelt werden solll, folgende 
Bits können dafür gesetzt werden: 
Bit_Funktion 
O0 Block auf Track im RAM speichern 
1 Block erst ins RAM und dann Track auf Disk 
2  Block-Checksumme (Offet 20) eintragen (s. Kapitel 3) 
3 alten Track bei Trackwechsel vorher auf Disk speichern 
D2 = Adresse eines Puffers von 512 Bytes, wo die un- 
kodierten Daten des Blocks stehen 
Rückgabe: => DO = Blockadresse oder O0, wenn Error aufgetreten 
Erklärung: 
Diese Funktion kodiert einen Block zwischen O und 1759 ins MFM- 
Format und speichert diesen auf Diskette oder RAM ab. Die uncodier- 
ten Daten stehen im Blockpuffer von 512 Bytes, welche Adresse im 
Datenregister D2 übergeben wurde. 
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Es folgen die 


nform itel 2 


mblerlisti der beiden Funktionen: 


;--- einen Block von Disk/RAM laden . 


- = 


- - 


Bit 1 
- Bit 2 


m... 
’ 


;--- es wird nur der gewuenschte Block decodiert - 
;— (D0,D1,D2) (Blocknr.,Mode,Blockadresse) . 
;--- Mode: Bit 0 = Block von RAM laden - 
Block neu von Disk laden ae 
Checksummenueberpruefung (Offset 20) - 


je Bit 3 = alten Block auf Disk speichern, . 
je wenn sich Tracknummer aendert -n 
-- => DO = Blockadresse, oder 0 wenn Fehler en 


LoadBlock: 

move. d2,a0 

move. d1,d2 

and.| #$ffff,dO 

divu #11,d0 

move.| dO,d1 

cir.w d1 

swap dI 

and.| #$ffff,dO 

btst #3,d2 

beqg.b Ib_2a 

cmp.w tracknummer,‚dO 
beq.b Ib_2a 

movem.| dO-d2/a0,-(sp) 
move.w tracknummer,dO 
bsr.w writemfmtrack 

tst.| dO 

beq.b Ib_error 

movem.| (sp)+ ‚dO-d2/a0 
Ib_2a: 

movem.| dO-d2/a0,-(sp) 
btst #0,d2 

beq.b Ib_3 

cmp.w tracknummer,dO 
beq.b Ib_ram 

Ib_3: 

bsr.w readmfmtrack 

tst.| dO 

bne.b Ib_ ram 

Ib_error: 

movem.| (sp) + ‚dO-d2/a0 
moveq #0,d0 

rts 

Ib_ ram: 

movem.l| (sp) + ‚dO-d2/a0 


; Blockadresse 


; DI = SektorNummer 
; DO = Tracknummer 
; alten Track auf Disk speichern ? 


; Track noch im Speicher ? 


; Track vorher abspeichern 


; Track/Sektor/Mode 
; Block von RAM laden ? 


; wenn ja, Track im Speicher ? 


; Rueckgabe DO = Trackadresse 
; konnte Track geladen werden ? 
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lea sektoradressen, al ; Sektoradresse 
add.w d1,dI ‚ ermitteln 
add.w d1,d1 

move.| (al,d1.w),al ; Sektoradresse 
lea 64(al),al ; Sektordaten 


move.| a0,a3 


> Einen Block decodieren 
;—- Al = Zeiger auf Quelle, A3 = Zeiger auf Ziel 


lea $dff000,a6 ; Chipbasisadresse 


moveq #-1,d5 

move.| d5,$44(a6) ; Firs/LastMask 

moveq #0,d5 

move.| d5,$62(a6) ; Modulo B und A loeschen 
move.w d5,$66(a6) ; Modulo D loeschen 

move.w #$5555,$70(a6) ; Daten Quelle C (Taktbits) 

lea 510(a1),al ; Ende erste Hälfte (minus 1 Word) 
move.| a1,$50(a6) ; Quelle A (ungerade Bits) 

lea 512(al),al ; Zeiger auf Ende zweite Hälfte 
move.| a1,$4c(a6) ; Quelle B (gerade Bits) 

lea 510(a3),a4 ; Ende vom Ziel (minus 1 Word) 
move.| a4,$54(a6) ; Ziel D (Bits wieder zusammen) 
move.| #51dd80002,$40(46) ; BLTCONO und BLTCONI 
move.w #%0808,$58(a6) ; Blitter starten 

Ib wait: 

btst #14,$2(a6) ‚ auf Blitterende warten 

bne.b Ib_wait 

move.l a3,dO ; Blockadresse 

btst #2,d2 ; Checksumme ueberpruefen ? 
bne.b Ib_check 

rts 


;--- Checksumme berechnen --- 
;-- A3 = Verwaltungsblock -—- 
Ib_check: 

move.| a3,al 

moveq #$7f,d1 

moveqg #0,d3 

move.| 20(a3),d2 

move.| d3,20(a3) 
Ib_checkloop: 

sub.| (a3)+ ‚d3 

dbf d1,l!b_checkloop 

move.| d2,20(a]) 

cmp.| d2,d3 

beq.b Ib_end 
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moveq #0,d0 ; Fehler 
Ib end: 
rts 


;--- einen Block auf Disk/RAM speichern - 
;--- es wird nur der gewünschte Block codiert u 
;— (D0,D1,D2) (Blocknr.,Mode,Blockadresse) a 
;--- Mode: Bit 0 = Block auf RAM speichern - 
jan Bit 1 = Block ins RAM und dann auf Disk speichern -- 
je Bit 2 = Checksummeneintragung (Offset 20) - 
a Bit 3 = alten Track auf Disk speichern, wenn sich - 
je Tracknummer ändert - 
;- => DO = Blockadresse, oder O wenn Fehler - 
SaveBlock: 

move.| d1,d3 

and. #$ffff,dO 

beq.b sb_2 

divu #11,d0 

move.| dO,d1 

cir.w d1 

swap d1 ; DI = SektorNummer 

and.! #$ffff,dO ; DO = Tracknummer 
sb 2: 

cmp.w tracknummer,dO ; Tracknummer noch im Speicher ? 
beq.b sb_track_in_ram 

movem.| dO-d3,-(sp) 

btst #3,d3 ; Track vorher auf Disk speichern? 
beq.b sb_no_bit3 

move.w tracknummer,dO 

bsr.w writemfmtrack 

tst.| dO 

bne.b sb_no_bit3 

sb_error: 

movem.| (sp) + ,‚dO-d3 

sb_el: 

moveq #0,d0 

rts 

sb_no_bit3: 

movem.| (sp)+,dO-d3 

movem.| dO-d3,-(sp) 

bsr.w readmfmtrack 

tst.| dO 

beq.b sb_error 

movem.| (sp) + ,dO-d3 


Seite 265 


Das Amiga-Diskettenformat Kapitel 2 


sb _track_in_ram: 

move.| d2,a0 ; Quelle 

btst #2,d3 ; Checksumme eintragen ? 
beq.b sb_no_check 

;--- Checksumme berechnen --- 

;- AO = Verwaltungsblock -- 
sb_check: 

move.| a0,a3 

moveq #$7f,d5 

moveq #0,d4 

move.| d4,20(a0) 

sb_checkloop: 

sub.| (a3)+ ,d4 

dbf d5,sb_checkloop 

move.l d4,20(a0) 

sb_no check: 

move.| | mfmcode,al ; Trackadresse 
lea sektoradressen,al 

move.| d1,d4 

add.w d4,d4 

add.w d4,d4 

move.| (al,d4.w),al ; Sektoradresse 
moveq #1,d2 

bsr.b codeblock 

move.| a0,dO 

btst #1,d3 ; Track auch auf Disk speichern ? 
bne.b sb_savetrack 

rts 

sb_savetrack: 

move.| a0,-(sp) 

move.w tracknummer,dO 

bsr.w writemfmtrack 

move. dO,d1 

move.| (sp)+ ,‚dO 

tst.| d] 

beq.b sb_e1 

rts 
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2.9 Schreibschutz abfragen 


Bevor wir Daten auf Diskette speichern können, müssen wir natürlich 
wissen, ob die Diskette schreibgeschützt ist. Diese Aufgabe erledigt 
für uns die nachfolgende Funktion. 


Routine: DiskProtect () 

Parameter: keine 

Rückgabe: => DO = 0, dann schreibgeschützt, -1 = nicht schreib. 
Erklärung: Diese Funktion testet eine Diskette auf Schreibschutz 


;--- Testen ob Diskette schreibgeschützt ist he 
;-- Rückgabe in DO = O , dann schreibgeschützt -- 
bau = -], dann nicht schreibgeschützt --- 
DiskProtect: 

moveg #0,d0 

btst #3,$bfe001 

beg.b dp! 

moveg #-1,d0 

dp!: 

rts 


2.10 Diskette formatieren 


An dieser Stelle möchte ich kein Beispiellisting zum Formatieren einer 
Diskette einfügen. Denn mit den bisherigen Routinen und dem 
Wissen müßten Sie eigentlich selbst in der Lage sein, eine Funktion 
dieser Art zu programmieren. Dazu brauchen Sie nur eine Schleife 
programmieren, die einen leeren Blockpuffer 11 mal in den Track- 
puffer kodiert und diesen dann abspeichert. Das ganze wiederholen 
Sie dann 159 mal, so das alle Tracks gelöscht werden. 


Wie Sie den Boot- und Rootblock initialisieren wird im nächsten 
Kapitel beschrieben. 
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2.11 HD-Disketten 


Auch der Amiga unterstützt ab OS 3.0 HD-Disketten. Dafür sind aber 
HD-Laufwerke und -Disketten notwendig. Die Kapazität beträgt dann 
das doppelte von einer normalen Diskette. Es werden auch HD- 
Laufwerke von Fremdherstellern mit eigenem Treiber angeboten. 


2.12 DOS-Kopierprogramm 


Auch ein Kopierprogramm möchte ich hier nicht einfügen, das würde 
den Rahmen des Buches sprengen. Zudem reicht auch dafür Ihr 
Wissen und die Funktionen aus, um ein einfaches DOS-Kopierpro- 
gramm zu schreiben. 


2.13 Kopierschutz 


Kopierschutzmöglichkeiten gibt es viele. Die einfachste Form ist wohl 
die der Paßword- bzw. Code-Abfrage in einem Programm. Dabei wird 
zu Beginn und oder während des Verlaufs nach einem bestimmten 
Code gefragt. Dieser steht meistens auf einem Papier, welches sich 
sehr schlecht kopieren läßt. 


Eine weitere Möglichkeit ist bei reinen Diskettenspielen, überlange 
Tracks auf die Diskette zu schreiben (Long-Track). Solche Tracks 
können dann nur mit sehr langsamen Laufwerken oder einer Hard- 
ware kopiert werden. 


Man kann auch versteckte Informationen auf der Diskette unter- 


bringen (Info-Block). Oder die Daten werden in einer bestimmten 
Reihenfolge auf die Diskette geschrieben (Sektor 1,4,6,4,2 usw.). 
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Wie man schon sieht, gibt es unzählig viele Arten ein Programm zu 
schützen. Aber es gibt keinen Kopierschutz der 100%ig ist. Jeder 
Schutzmechanismus wird früher oder später geknackt. Das paradoxe 
ist, je besser der Kopierschutz, desto mehr reitzt es die Cracker diesen 
zu entfernen und umso schneller ist das Programm als Raubkopie auf 
dem Markt. 


2.14 Tips & Tricks 


Ein Nachteil entsteht leider, wenn man das Betriebssystem aus- 
schaltet, um die eigenen Diskfunktionen nutzen zu können. Es wird 
nämlich kein Diskettenwechsel während dieser Zeit vom Betriebs- 
system erkannt. Werden anschließend Daten auf Diskette über das 
DOS gespeichert, kann die Diskette zerstört werden. 


Ein einfacher Trick um das zu umgehen ist, wenn Sie die Diskette, 
nach Wiedereinschalten des Systems, sie einmal rausziehen und 
wieder reinlegen. Eine andere Möglichkeit ist, die DOS-Funktion 
"OPEN()" aufzurufen und ihr nur den Namen eines Laufwerks 
übergeben (zum Beispiel "DFO:") und danach die DOS-Funktion 
"CLOSE ()" aufrufen. 


Das Beste ist sowieso, Sie programmieren über die LowLevel-Library 
(s. Abschnitt 14). 


Seite 269 


Filev tun ite| 


3. Fileverwaltung 


Wenn man Daten auf eine Diskette oder einem anderen Datenträger 
speichern bzw. von dort laden möchte, so geschieht dieses über das 
Amiga-File-System. Das File-System ist nichts anderes als ein Task 
(Programm), welcher für jedes Gerät (Festplatte, Disk etc.) erzeugt 
wird und den Datentransfer über das entsprechende Device 
selbständig vornimmt. Das mag auf den ersten Blick ein wenig 
umständlich erscheinen, hat aber den Vorteil, daß jedes gewünschte 
Gerät angesprochen werden kann. 


Da wir aber eigene Funktionen programmieren möchten, mit denen 
wir den Datentransfer vornehmen werden, brauchen wir uns um 
Tasks und Devices nicht zu kümmern. Für uns ist der Aufbau der 
Datenstruktur auf der Diskette wichtiger. 


Damit das File-System ein gespeichertes File später auf Diskette 
wiederfinden kann, muß das File zuvor in einem bestimten Format 
auf die Diskette gebracht werden, welche untereinander auch wieder 
miteinander verbunden werden müssen. 


Das Ganze kann man sich wie ein Fachbuch vorstellen. Wenn Sie 
bestimte Informationen über ein Thema suchen, so schlagen Sie 
zuerst das Inhaltsverzeichnis auf, denn dieses befindet sich ja immer 
am Anfang des Buches, und braucht somit nicht großartig gesucht zu 
werden. Danach durchsuchen Sie dieses auf den zutreffenden 
Oberbegriff und wenn Sie ihn gefunden haben, durchsuchen Sie die 
Unterbegriffe nach dem Gewünschten, welchen Sie auch hoffentlich 
finden. Danach merken Sie sich die Seitenzahl und schlagen sie auf. 
Jetzt können Sie endich auf die gesuchten Daten zugreifen (lesen). 
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Beim Ami ft Ganze fo Ben ab: 


(1).Bootblöcke lesen (0 und 1). Enthält Informationen um was für 
eine Diskette es sich handelt, wie sie formatiert wurde und wo 
sich der Rootblock (Stammbaum - Inhaltsverzeichnis) befindet. 


(2.)Rootblock lesen (880). Über den können auf die einzelnen 
Unterverzeichnisse (UserDir-Blöcke) oder Files (Fileheader-Blöcke) 
zugegriffen werden. 


(3.) Falls erforderlich die UserDir-Blöcke durchsuchen und dann den 
Fileheader-Block laden. 


(4.)Über den Fileheader-Block auf die Data-Blöcke zugreifen, welche 
die Daten des Files enthält. 


Nachdem nun bekannt ist, wie die Datenstruktur der Diskette unge- 
fähr aufgebaut ist, folgt jetzt eine genaue Beschreibung der einzelnen 
Informationsblöcke (Bootblock etc.) 


3.1 Bootblock (0 und 1) 


Wird eine Diskette in ein Laufwerk gelegt, so werden sofort die 
Blöcke O und 1 in den Speicher geladen (1024 Bytes). Denn in den 
ersten 12 Bytes sind alle notwendigen Informationen über die 
Diskette gespeichert, die für die Fileverwaltung erforderlich sind. 
Danach folgt evtl. ein Bootprogramm, das gestartet wird und testet 
ob das DOS-System in Ordnung ist. 
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Die ersten 12 Bytes sehen dabei golgendermaßen aus: 


Offset Typ _Name Beschreibung 
00 L DOSx Kennzeichnung einer Dosdiskette. 3stelliger ASCII- 


Wert und eine Ziffer zwischen O und 5, welche 

folgende Bedeutung hat: 

Old-File-System 

Fast-File-System 

Old-File-System mit Intenationalisierung 

Fast-File-System mit Intnationalisierung 

Old-File-System mit Directory-Cache 

New-File-System mit Directory-Cache 

04 L _ Checksum Checksumme für die Bootblöcke 

08 L  Rootblock Nummer des Rootblocks (normal = 880) 

12 B  BootPrg ab hier beginnt evtl. ein Bootprogramm, 
welches maximal 1012 Bytes lang sein 
darf und PC-Relativ programmiert sein 
muß. 


u pwN- Oo 
ıı u EN 


Beim Old-File-System besteht jeder Datenblock aus maximal 488 
Bytes, einigen Parametern und Zeigern. Das Fast-File-System besitzt 
eine Datenblocklänge von 512 Bytes; es kann somit mehr Daten 
aufnehmen und die Schreib-/ Lesevorgänge werden auch beschleu- 
nigt. Die Internationalisierung erlaubt unter anderem auch Umlaute 
ohne Probleme zu verwenden. Durch das Directory-Cache kann man 
das Inhaltsverzeichnis sehr schnell auslesen. Dazu werden die 
wichtigsten Informationen eines Directories oder Files nochmal 
zusätzlich in einem bestimmten Format auf die Diskette gespeichert, 
welches schnell einlesbar ist. Dieses hat aber den Nachteil, daß die 
Datenkapazität der Diskette geringfügig kleiner wird. Beim Directory- 
Cache wird die Internationalisierung automatisch mit eingeschaltet. 


Wird die Diskette installiert, so befindet sich ab Offset 12 ein Boot- 
programm, das mit Hilfe der Funktion FindResident () (Exec) testet, 
ob die Doslibrary resident vorliegt. Ist dieses nicht der Fall, so wird 
eine Errormeldung zurückgegeben und die Diskette bootet nicht. 
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Standartbootprogramm (Kick 1.2/1.3/2.0): 

lea dosname(pc),al 
jsr -$60(a6) ; FindResident () 
tst.! dO ;‚ auf Fehler testen 
beq Error 
move.| dO,a0 ; Dos-Struktur nach AO 
move.| 22(a0),a0 ; Initialisierungsroutine 
moveq #0,d0 ; Keine Fehlermeldung 
rts ; Ende 

Error: 
moveq #-1,d0 ; Fehlermeldung 
rts ; Ende 


dosname: dc.b "dos.library",O 


Ab Kickstart 3,x Sieht das Bootprogramm etwas anders aus, Dann 
wird’ auch noch getester ob eine Expansionslibrary vorhanden 1St. 


B r mm (Ki s 


lea expname(pc),a 1 ; Libraryname 
moveqg #37,d0 ; Version V37 (Kick 3.x) 
jsr -$228(a6) ; OpenLibrary () 
tst.| dO ; Testen ob Expansions- 
beq NoExpanlib ; library vorhanden ist ? 
move.| dO,al ; Expansionsstruktur 
bset #6,$22(al) 
jsr -$19e(a6) ; CloseLibrary () 
NoExpanlib: 
lea dosname(pc),a 1 
jsr -$60(a6) ; FindResident () 
tst.| dO ;‚ auf Fehler testen 
beq Error 
move.| dO,a0 ; Dos-Struktur nach AO 
move.| 22(a0),a0 ; Initialisierungsroutine 
moveqg #0,d0 ; Keine Fehlermeldung 
rts ; Ende 
Error: 
moveq #-1,d0 ; Fehlermeldung 
rts ; Ende 


dosname: dc.b "dos.library",O 
expname: dc.b "expansion.library",O 
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Als letztes fehlt uns noch die Berechnung der Checksumme. Diese 
wird über die gesamten 1024 Bytes (256 Longwords) gebildet. Dazu 
folgt hier ein Listing, das im Adressregister AO die Adresse des 
Bootpuffers übergeben werden muß; die Checksumme wird berechnet 
und in Offset 4 eingetragen. 


;--- Bootblock-Checksumme berechnen und eintragen 
;—- AD = Bootpuffer (1024 Bytes) 
InsertBootChecksum: 
moveq #0,d0 ; Checksumme auf Null setzen 
lea 4(a0),al 
move.| dO,(al) ; Alte Checksumme löschen 
move.w #255,d1 ‚256 Longs 
IBC_loop: 
add.| (a0) + ,dO 
bcc IBC_2 
addq.| #1,d0 
IBC_2: 
dbra d1,IBC_loop 
not.| dO 
move.| dO,(al) ; neue Checksumme eintragen 
rts 


3.1.2 Rootblock (880) 


Im Bootpuffer ab Offset 8 steht die Rootblocknummer, die bei 
Disketten in der Regel 880 lautet. Dieser Rootblock ist der wichtigste 
Block, weil er das Hauptverzeichnis einer Diskette beinhaltet. Über 
dieses Verzeichnis kann auf alle Files und Directories direkt oder 
indirekt zugegriffen werden. Denn wie schon bereits erwähnt, legt 
der Amiga seine Files bzw. Directories in Verzeichnissen auf Diskette 
ab. Dabei unterscheidet man folgende Verzeichnisse: 
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RootBlock (Hauptverzeichnis) 

UserDir-Block (Directory bzw. Unterdirectory) 
FileHeader-Block (Fileverzeichnis) 

3 FileList-Block (Zusatz-Fileverzeichnis) 

2 Data-Block (Enthält Datenbytes eines Files) 


=> Jedes Verzeichnis ist 512 Bytes lang. 


Fangen wir mit der Beschreibun s Rootblocks an: 


Der RootBlock (Hauptverzeichnis) 


000 


004 
008 
012 


016 
020 
024 


312 


316 


420 
424 
428 
432 


484 
488 
492 
496 
500 
504 


508 
512 


Y 
L Type 


L Headerkey 
L Highseq 
L HT-Size 


L Checksum 
L HashTable 


L BM-Flag 


L BM-Table 


L Days 
L Mins 
L Ticks 
B DiskName 


L CreateDays 
L CreateMins 
L CreateTicks 
L NextHash 
L ParentDir 
L DCB 


L Sec.Type 
END 


Blocktyp = T.SHORT (Wert 2) für ein Hauptverzeichnis 
(enthält niemals Datenbytes) 

keine Bedeutung (immer Null) 

Größte Sequencenummer (immer Null) 

Puffergröße der Hashtabelle in Longwords 

(bei Diskette immer 72 [$48] Longwords) 

Frei (immer Null) 

Checksumme über diesen Block 

hier stehen die Anfangsblocknummern der Files bzw. Direc- 
tories (max. 72 Einträge) => siehe Hasheintragberechnung 
enthält den Wert -] (wenn min. 1 Eintrag auf Disk) oder 

1 (wenn kein Eintrag auf Disk), wenn die Bitmap der Disk in 
Ordnung ist. Bei jedem anderen Wert ist die Bitmap der Disk 
ungültig und sollte dann nicht mehr beschrieben werden. 
Tabelle von 26 Longwords, welche die Blocknummern der 
Disk-Bitmap enthält. Bei der Diskette reicht einer. 

Datum: Anzahl Tage seit 1.1.78 für letzten Schreibzugriff 
Datum: Anzahl Minute seit 00:00 Uhr für letzten Schreibzug. 
Datum: Anzahl Ticks (50 Ticks = 1 Sekunde) für letzten Schr. 
ab hier liegt der Name der Diskette. Max. 30 Zeichen; das 1. 
Byte gibt die Anzahl Zeichen an, danach folgt der Name. 
Tag der Erstellung dieser Diskette (Format wie Days) 

Minute der Erstellung dieser Diskette (Format wie Mins) 
Sekunde der Erstellung dieser Diskette (Format wie Ticks) 
nächster Hasheintrag => immer Null 

Blocknummer des übergeordneten Verzeichnis (immer Null) 
Blocknummer für Directory-Cache (ab Kick-start V3.x) 

=> siehe Abschnitt 3.1.7 

Sekundär-Blocktyp = ST.ROOT (Wert 1) für eindeutige 
Identifizierung des Rootblocks 

Ende des Rootblocks 
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3.1.3 Der UserDir-Block 


Als nächstes folgt der UserDir-Block. Dieser wird immer angelegt, 
wenn ein Directory oder ein Unterdirectory auf der Diskette erzeugt 
wird (zum Beispiel mit der MakeDir-Funktion). Dieses Verzeichnis 
ähnelt sehr dem des Rootblocks, wie Sie gleich feststellen können, 


Der UserDir-Block: (Directory bzw. Unterdirectory) 


000 
004 
008 
012 
016 
020 
024 


312 
316 
320 


324 
328 
420 
424 
428 
432 
484 
488 
492 
496 
500 


>04 
508 


512 


DET FETFFEPT 


rettet 


ET 


Typ N 


Type 
HeaderkKey 
HighSeq 
HT-Size 
Checksum 
HashTable 


Protect 


Comment 
CreateDays 
CreateMins 
CreateTicks 
DiskName 


NextHash 
ParentDir 


DCB 
Sec.Type 


END 


rei 
Blocktyp = T.SHORT (Wert 2) für ein Hauptverzeichnis 
Blocknummer von diesem UserDir 
Größte Sequencenummer (immer Null) 
Hat hier keine Funktion (immer Null) 
Frei (immer Null) 
Checksumme über diesen Block 
hier stehen die Anfangsblocknummern der Files bzw. Direc- 
tories (max. 72 Einträge) => siehe Hasheintragberechnung 
Frei (immer Null) 
Frei (immer Null) 
Status des Directories 


Delete=1, Datei kann gelöscht werden 

Execute= 1, Datei kann von Shell ausgeführt werden 
Write=1, Datei kann überschrieben werden (ab V36) 
Read= 1, Datei kann gelesen werden 

Archive, wird gesetzt, wen sich die Daten ändern (Update) 
Pure 

Script=1, Datei ist ein ausfühbares Textfile 

Frei (immer Null) 

Kommentar zum Dir. (wie DirName aber max. 80 Zeichen) 
Tag der Erstellung von diesem Directory 

Minute der Erstellung 

Sekunde der Erstellung 

ab hier liegt der Name des Directories (siehe Rootblock) 
Frei (immer Null) 

Frei (immer Null) 

Frei (immer Null) 

nächster Hasheintrag mit gleichem Wert (s. Hashberechnung) 
Blocknummer des übergeordneten Verzeichnis 

(entweder der RootBlock oder ein UserDir) 

Blocknummer für Directory-Cache (ab Kickstart V3.x) 
Sekundär-Blocktyp = ST.USERDIR (Wert 2) 

für eindeutige Identifizierung des UserDir-Blocks 

Ende des UserDir-Blocks 


Nun 2we — Olss 
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3.1.4 Der FileHeader-Block 


Bis jetzt kennen wir nur den Aufbau der Verzeichnisse von Directories 
(UserDir- bzw. Root- Block). Was uns noch fehlt, ist die Beschreibung 
des Fileverzeichnisses, das beim Speichern eines Files auf Diskette 
erzeugt wird - der FileHeader-Block. 


FileH -Bl Fileverzeichnis); 


T : 

000 L Type Blocktyp = T.SHORT (Wert 2) für ein Hauptverzeichnis 

004 L Headerkey Blocknummer von diesem FileHeader-Block 

008 L Highseq Anzahl der Data-Blöcke, die in diesem FileHeader-Block einge- 
tragen sind (max. 72 [$48] Nummern von Data-Blöcken) 

012 L Data-Size Hat hier keine Funktion (immer Null) 

016 L FirstData Nummer des ersten Data-Blcoks 

020 L Checksum Checksumme über diesen Block 

024 L DataBlocks hier stehen die Anfangsnummern der Data-Blöcke. Die Tabelle 
beginnt ab Offset 308 und zählt rückwärts. (max. 72 Einträge) 

308 L DataStart Nummer des ersten Data-Blocks (Tabellenanfang -> gleiche 
Nummer wie in FirstData) 

312 L - Frei (immer Null) 

316 IL ——— Frei (immer Null) 

320 L Protect Status des Files (siehe UserDir-Block) 


324 L ByteSize Länge des Files in Bytes 

328 B Comment Kommentar zu diesem File (siehe UserDir-Block) 

420 L CreateDays Tag der Erstellung von diesem Directory (siehe UserDir-Block) 
424  LCreateMins Minute der Erstellung (siehe UserDir-Block) 

428 LCreateTicks Sekunde der Erstellung (siehe UserDir-Block) 


432 L FileName ab hier liegt der Name des Files (siehe UserDir-Block) 
484° L mm Frei (immer Null) 
488 L Frei (immer Null) 
492 L m Frei (immer Null) 
496 L NextHash nächster Hasheintrag mit gleichem Wert (s. Hashberechnung) 
500 L ParentDir Blocknummer des übergeordneten Verzeichnis 
(entweder der RootBlock oder ein UserDir) 
504 L Extension Nummer des FileList-Blocks, wenn File zu lang ist 


(siehe FileList-Block) 

508 L Sec.Type Sekundär-Blocktyp = ST.File (Wert -3). Für eindeutige 
Identifizierung eines File-Blocks 

512 END Ende des FileHeader-Blocks 
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3.1.5 Der FileList-Block 


Da der FileHeader-Block nur die Nummern von maximal 72 Data- 
Blöcken aufnehmen kann, benötigen wir einen Zusatzblock (oder 
mehrere), der die restlichen Nummern aufnimmt, wenn das File zu 
lang ist. Dieses ist der sogenannte FileList-Block, dessen Nummer ab 
Offset 504 (im FileHeader- bzw. FileList-Block) eingetragen wird. Falls 
das immer noch nicht ausreichen sollte, wird ein weiterer FileList- 
Block an den letzten gehängt usw. 


Der FileList-Block (Zusatzfileverzeichnis): 


7 a 

000 L Type Blocktyp = T.LIST (Wert 16) für File-Erweiterungsblock 

004  L Headerkey Blocknummer von diesem FileList-Block 

008 L HighSeq Anzahl der Data-Blöcke, die in diesem FileList-Block einge- 
tragen sind (max. 72 [48] Nummern von Data-Blöcken) 

012 L Data-Size Hat hier keine Funktion (immer Null) 

016 L FirstData Keine Bedeutung = >immer Null 

020 L Checksum  Checksumme über diesen Block 

024 L DataBlocks hier stehen die Anfangsnummern der Data-Blöcke. Die Tabelle 
beginnt ab Offset 308 u. zählt rückwärts. (max. 72 Einträge) 

308 L Data$tart Nummer des ersten Data-Blocks (Tabellenanfang) 


zo alle Eintröge von Offset 312 bis 
;- einschließlich 496 ungenutzt => Null 


500 L ParentDir Blocknummer des übergeordneten FileHeaders 

504 L Extension Nummer eines weiteren FileList-Blocks, wenn File zu lang ist. 

508 L Sec.Type Sekundär-Blocktyp = ST.File (Wert -3). Für eindeutige 
Identifizierung eines File-Blocks. 

512 END Ende des FileList-Blocks 
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3.1.6 Der Data-Block 


Zu guter Letzt folgt jetzt noch die Beschreibung des Data-Blocks, 
dessen Nummer ja in dem FileHeader bzw. FileList-Block eingetragen 
wird. Dieser Block enthält die eigentlichen Datenbytes eines Files. 
Beim Old-File-System werden nur 488 Bytes des Blocks genutzt und 
die restlichen für die Verwaltung. Beim Fast-File-System werden die 
gesammten 512 Bytes des Data-Blocks genutzt. 


Der Data-Block (Filedatenbytes für OFS): 


rei 
000 L Type Blocktyp = T.Data (Wert 8) für einen Datenblock eines Files 
004 L Headerkey Nummer des FileHeader-Block für diesem Data-Block 
008 L SeqNum relative Nummer von diesem Datenblock. 
Alle Datenblöcke eines Files werden von 1 an aufwärts durch- 
nummeriert. 
012 L Data-Size Anzahl der Datenbytes in diesem Block (488 o. weniger) 
016 L NextData Nummer des nächsten Datenblocks (Blocknummer) 
020 L Checksum Checksumme über diesen Block 
024 B Data ab hier folgen die eigentlichen Datenbytes (max. 488) 


3.1.7 Der Directory-Cache-Block 


Ab Kickstart 3.0 können beim Formatieren einige neue Funktionen 
angegeben werden. Unter anderem die Verwendung des Directory- 
Caching. Dieses hat den Vorteil des schnellen Directorieauslesens. 
Dazu wird in dem Extension-Eintrag (Offset 504) vom Root- bzw. 
UserDir-Block die Nummer des Directoy-Cache-Blocks eingetragen. 
Dieser Block enthält dann alle wichtigen Daten der Files und Unter- 
Directories, welche im entsprechenden Directory eingetragen sind. 


ACHTUNG! - Alle Informationen sind‘ keine offiziellen, sondern 
wurden von mir, durch studieren des File-Systems, herausgelunden. 
Deswegen können die Bezeichnungen der Einträge von denen der 
originalen abweichen. 
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Der DCB-Block (Directory-Cache-Block): 


Offset Typ Name Beschreibu 

000 L Type Blocktyp = T.DirCache (Wert 33 = $21) für einen Directory- 
Cache-Block 

004 L Headerkey eigene Nummer dieses DCB-Blocks 

008 L Parent Nummer des Root- bzw. UserDir-Blocks, zu dem dieser DCB- 


Block gehört 

012 L DCB-Size Anzahl der Einträge in diesem Block 

016 L Extension Nummer des nächsten DCB-Blocks, wenn dieser nicht alle 
Einträge des Verzeichnisses aufnehmen konnte. 

020 L Checksum Checksumme über diesen Block 

024 B Info ab hier folgen die einzelnen Einträge in Form von Info- 
Strukturen, welche die wichtigsten Parameter über das File 
bzw. Unter-Directory enthalten, die in diesem Directory 
enthalten sind. 


Aufbau einer Info-Struktur: 


Offset T eibu 
000 L Headerkey Blocknummer für dieses File bzw. Directory 
(vom FileHeader- oder UserDir-Block) 


004  L ByteSize Filelänge des Files oder Null bei einem Directory 
008 L nn reserviert (Null) 

012 L reserviert (Null) 

016 \W Days Erstellungstag (nur bei Files) 

018 W Mins Erstellungsminute (nur bei Files) 

020 W Ticks Erstellungssekunde (nur bei Files) 


022 B Sec.Type Kopie des Sekundär-Typ-Eintrags (2 = Directory, -3 = File) 

023 B NameS$ize Länge des Filenames in Bytes 

024 B Name ab hier liegt der Name des Files bzw. des Directories, welcher 
mit einem Null-Byte endet. 


Die nächste Info-Struktur folgt direkt ab der nächsten geraden 
Adresse. Falls ein DCB für alle Einträge nicht ausreichen sollte, muß 
ein weiterer angelegt werden, dessen Nummer in Extension (Offset 
016) eingetragen wird. 
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3.2 Hashberechnung 


Möchte man ein File von der Diskette laden oder darauf speichern, 
so muß ein Hashwert über den Dateinamen errechnet werden, der 
zwischen 6 und 77 liegt (= 72 Einträge). Dieser gibt die Longword- 
Position in der Hashtabelle an, welche wir im Root- bzw. UserDir- 
Block finden. Dabei kann es vorkommen, daß ein Platz in der Tabelle 
schon belegt ist, dann befindet sich die nächste Position im 
NextHash-Eintrag (Offset 496) vom hier bereits eingetragenden Block 
USW. 


Die Position des Hash-Eintrages wird‘ nach folgender Formel be- 
rechnet: 


HP = Dateinamenlänge 


ro Buc des Dateinamens: 

HP = HP * 13 

HP = HP + ASCII_Wert des Zeichens (immer Großbuchstaben) 
HP = HP and $7fff (Und-Verknüpfung) 
wenn alle Buchstaben durch: 

HP = HP modulo 72 (72 = max. Anzahl Einträge) 
HP = HP + 6 


Es folgt ein kleines Listing, das den Hashoffset berechnet und 
gleichzeitig auch die Blocknummer wiedergibt, die evtl. unter dem 
Hashoffet schon eingetragen ist. 


;--- Filename in HashOffset umwandeln 

;—- (A2,A3) (Hashtable,Filename) 

—- => DO = Blocknr. oder 0 = Error 

—- => DI = Hashoffset oder -1 = Error 
GetHashBlock: 

move.| a3,a4 

moveq #0,d0 ; Anzahl Buchstaben 
moveq #29,d1 ; maximal 30 Zeichen 
ghb_name: 

tst.b (a4)+ 

beq.b ghb 1 
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addq.w #1,d0 
dbra d!,ghb_name 
moveq #-1,d1 
ghb_error: 

moveq #0,d0 

rts 

ghb 1: 

move.| dO,d1 
subg.w #1,d1 
moveq #0,d2 
move.| a3,a4 
ghb_offset_loop: 
mulu #13,dO 
move.b (a4)+ ,d2 
bsr.b bigascıi 

add.| d2,dO 

and.w #$7ff,dO 
dbra di,ghb_offset_loop 
divu #72,d0 

swap dO 

add.w dO,dO 
add.w dO,dO 
move.w dO,d1 
move.| (a2,d0.w),dO 
beq.b ghb_error 
cmp.w #1759,d0 
bhi.b ghb_error 

rts 


; Anzahl Buchstaben + |] 


; Error: zuviele Buchstaben 


; DO = Anzahl Buchstaben 
DI = Loopzähler 
= Filename 


; A4 


; Hash_Wert * 13 

; ASCII_ Wert holen 

; in BIG_ASCII wandeln 

; Hash_Wert + ASCII_Wert 

; mit $7fff UND-Verknüpfen 

; weiter mit nächstem Zeichen 
; Hash_Wert / 72 


Rest ermitteln (Modulo) 


‚ mal vier 


me u. 


= Hashbyteoffset 
Hashoffset nach DI 


; Blocknummer aus Hashtabelle 
; wenn Null, dann freier Eintrag 
; wenn > 1759 


u. u. 


dann Fehler 
Ende 


da ein ASCII zeichen umwandeln in Gross-ASCII 


i- D2 = ASCII-Wert 
;- Rueckgabe in D2 = NEW ASCII 
Bi u: 

cmp.b #"ä",d2 

beq.b bigascii_a 

cmp.b #"6",d2 

beq.b bigascii a 

cmp.b #"ü",d2 

beq.b bigascii_a 

cmp.b #"a",d2 

blo.b bigAscii_ end 

cmp.b #"z",d2 

bhi.b bigAscii_ end 

bigascii_a: 

sub.b #$20,d2 

bigAscii_ end: 

rts 
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3.3 Disk-Bitmap 


Wenn wir ein File auf Diskette oder einem anderen Datenträger 
speichern wollen, müssen wir wissen, welche Blöcke zur Speicherung 
noch frei sind. Ansonsten würden wir evtl. bereits bestehende Daten 
überschreiben und wir wüßten nie, wann die Kapazität erschöpft ist. 
Deswegen existiert der Bitmap-Block, welcher die nötigen 
Informationen enthält. Bei Disketten reicht ein Block aus, bei anderen 


Datenträgern, wie zum Beispiel der Festplatte, sind mehrere 
erforderlich. 


Bitmap-Block (Offset 316 im Root-Block): 


T 

000 L Checksum _Checksumme über diesen Block 

004 L Bitmuster ab hier folgen jeweils Longwords, welche die Informationsbits 
für alle Blöcke enthalten. Bit O des ersten Longwords steht 
für Block 2 usw. Ein gesetztes Bit steht für einen freien Block. 


3.4 Checksummen 


Als letztes fehlt uns noch die Berechnung der Checksummen für die 
einzelnen Blöcke, Diese ist für die Bitmap- und die restlichen Blöcke 
identisch. Sie unterscheiden sich lediglich an der Eintragsposition. 
Deswegen folgt hier auch nur ein Beispiellisting, das die Berechnung 
vornimmt. 


;-— Checksumme über Verwaltungsblock berechnen --- 
;— AO = Verwaltungsblock ER 
j-—- => DO =berechnete Checksumme nn 


move.l a0,al ; Blockadresse nach Al 
moveqg #127,d1 ; 128-1 Longwords 
moveq #0,d0 ; Checksummenzähler 
move.| 20(a1),d2 ; alte Checksumme retten 
move.| dO,20(a1) ; alte Checksumme löschen 
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Checksum loop: 


sub.| (a0) + ,dO ; Checksumme berechnen 

dbra di,checksum_loop 

move. d2,20(a1) ; alte Checksumme wieder eintragen 
rts 


Für die Berechnung der Bitmap-Checksumme müssen Sie überall im 
Listing den Offset 20 durch den Offset Null ersetzen. 
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4. Daten von Diskettte laden 


Da wir jetzt alles über die Hardwareprogrammierung und Filever- 
waltung der Diskette wissen, sind wir damit in der Lage über eigene 
Hardware-Routinen DOS-Files von Diskette zu laden. 


Das Laden der Daten ist eigentlich ziemlich einfach zu program- 
mieren. Dazu müssen wir zuerst über den Rootblock und die User- 
Dir-Blöcke den FileHeader-Block suchen. Über ihn können wir dann 
auf die Data-Blöcke zugreifen und die Daten in den Speicher laden. 


Es folgt jetzt das Beispiellisting "LoadFile ()", mit dem man Daten von 
DOS-Diskette in den Speicher laden kann. Allerdings wird nur das 
Old-File-System unterstützt. Für die Freaks unter Ihnen, dürfte es wohl 
kein Problem sein, die notwendigen Änderungen vorzunehmen, 
damit auch das Fast-File-System unterstützt wird. 


In den nächsten Kapitelabschnitten wird auch das Listing zum 
Speichern von Daten und zum Schluß werden noch alle erforderlichen 
Unterroutinen aufgeführt. Man könnte jetzt natürlich das Argument 
der Platzverschwendung aufführen. Aber ich bin der Meinung, 
gerade bei diesem Thema, ist ein ausführliches Abhandeln des 
Themas sehr hilfreich. Außerdem ist es auch viel übersichtlicher in 
einem Buch nachzuschlagen, als ständig in einem Listing hin- und 
herzuscrollen. Es werden auch nur die erforderlichen Listings zum 
DOS-Datentransfer aufgeführt und nicht wie in anderen Büchern eine 
überflüssige und unverstädliche ROM-Beschreibung, wo man nachher 
genau so schlau ist wie vorher. 


;- Ein DOS-File von Disk laden (OFS) 

;-- (DO,D2,A0,A1) (Laenge,Mode,Name,Puffer) u. 
= Mode: 0 = Normal, 1 = Motor bleibt an und selbe Disk . 
;— muß im Laufwerk bleiben, 2 = Motor ausschalten - 
;- => DO = Anzahl Bytes , oder O = Error - 
LoadfFile: 


move.| dO,F Laenge ; Filelänge retten 
move.| a0,F Name ; Filename 
move.| al,F Puffer ; Filepuffer 
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cmp.w #2,d2 ; Motor ausschalten ? 
bne.b LF s ; wenn nicht, dann weiter 
bsr.w MotorAus ‚ sonst Motor = aus 
cIr.w F_SMode ; MotorMode = O 
moveq #0,d0 OR 

rts ; Ende 

LF $: 


move.w F SMode,d?” ; OLD MotorMode 
move.w d2,F SMode ; New MotorMode 
cmp.w #1,d7 ; File in Benutzung ? 
bne.b LF_ go ; wenn nicht, dann weiter 
move.| F BlockNr,dO ; sonst 

beqa.b LF Error ‚ alte 

move.| F_DataBlock,a0 ; Parameter wieder- 
moveq #0,d3 ; herstellen, um 
move.w F_ Offset,d3 _; Ladevorgang 
bmi.b LF_Error ; forsetzen 

beq.b LF_Error ‚ zu können 

cmp.w #488,d3 

bne.w LF Go _On ; weiter laden 
moveq #0,d3 

cIr.w F_Offset 

move.| 16(a0),dO ; nächster Datenblock 
bne.b LF Go On 

LF Error: 

bsr.w MotorAus 

cIr.w F_$Mode 

moveq #0,d0 

rts 

LF Go: 

bsr.w MotorAn 

tst.| dO 

bpl.b LF 1 

clr.w F_SMode 

moveq #0,d0 

rts 

LFI: 

cIr.w F_Offset 

bsr.w FindSubDir 

move.| a0,dO 

beq.b LF_Error 

lea 24(a0),a2 ; A2 = Hashtabelle 
move.| F Name,a3 ; A3 = Filename 
bsr.w GetHashBlock ; Blocknummer zum File suchen 
tst.! dO 

beq.b LF Error 
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LF Search _FileHeader: 
moveq #5,d1 

move.| F_FileBlock,d2 
bsr.w LoadBlock 

tst.| dO 

beq.b LF_Error 

move.| dO,a0 

cmp.| #-3,508(a0) 

beq.b LF SFH_Ok 

move.| 496(a0),dO 

beq.b LF Error 

bra.b LF Search _FileHeader 
LF_SFH_Ok: 

moveq #0,d0 

lea 432(a0),a2 

move.b (a2)+,dO 

cIr.b (a2,dO.w) 

move.| F Name,a3 

bsr.w CompName 

tst.| dO 

beq.b LF_ Found _FileHeader 
move.| 496(a0),dO 

beq.b LF Error 

bra.b LF Search FileHeader 


; Block vom RAM + Check 


; Fileheader laden 


‚ ST.File ? 


; NextHash ? 


AZ 
; DO 


Disk_Filename 
Filenamelaenge 


;A3 = Filename 
; Namen vergleichen 
; sind Namen gleich 


; NextHash_Block 
; vorhanden ? 


je ab hier Headerblock gefunden -- 


LF Found FileHeader: 
move.l 308(a0),dO 
LF Go _On: 

move. F_Puffer,a2 
move.| F Laenge,d4 
moveq #0,d5 

move.w F_Offset,d3 
LF Load Data: 

move. dO,F_BlockNr 
moveq #5,d1 

movem.| d3-d5/a2,-(sp) 
move.| F_DataBlock,d2 
bsr.w LoadBlock 
movem.| (sp) + ‚d3-d5/a2 
tst.| dO 

beq.w LF Error 

move.| dO,a0 

cmp.| #8,(a0) 

bne.w LF_Error 

move.l 12(a0),d1 

lea 24(a0,d3.w),al 


‚AO = Fileheader-Struktur zum File 


; FirstDataBlock 

; A2 = Datenzielpuffer 

; D4 = Datenlänge 

;D5 = tatsächlicher Datenzähler 
; D3 = Byteoffset 


; Block von RAM + Check 


‚AO = Dataßlock-Struktur 
; T.Data ? 


; Anzahl Bytes in diesem Block 
; Al = Quelle 
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sub.w d3,d1 

beq.w LF Error 
move.w d3,d6 
subq.w #1,d1 
moveq #0,d3 

LF Copy _Bytes: 
move.b (al)+ ‚(a2)+ 
addq.w #1,d6 
addaq.| #1,d5 

subq.| #1,d4 

beq.b LF Ok 

dbra d1,LF Copy_Bytes 


move.| 16(a0),dO 
bne.b LF Load Data 
cir.| F_BlockNr 
moveq #-1,d6 

clr.w F_SMode 

LF Ok: 

move.w d6,F Offset 
move.| d5,-(sp) 
cmp.w #1,F_SMode 
beq.b LF_OkA 
bsr.w MotorAus 
clr.w F_SMode 
LF_OkA: 

move.| (sp)+ ,‚dO 

rts 


F_BlockNr: dc.l 0 


; DI = Loopzaehler 


; Byteoffset 


; Byteoffset + 1 
; Datenzaehler + 1 
; Datenlaenge -1 


; Naechster Datenblock 


; Motor anlassen ? 


; Anzahl Bytes 


4.1 Daten auf Diskette speichern 


Wie bereits erwähnt folgt jetzt das Listing "SaveFile ()" zum Speichern 
von Daten auf einer DOS-Diskette. Auch hier wird nur das Old-File- 
System unterstützt. Deswegen müssen Sie immer darauf achten, daß 
Sie wirklich nur solche Disketten benutzen. Ansonsten würde die 
Diskette evtl. zerstört werden. 


Das Speichern ist erheblich aufwendiger, wie Sie an der Länge des 
Listings feststellen können. Denn es müssen ja FileHeader-, evtl. 
FileList- und Data- Blöcke erstellt werden. 
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;—- Ein DOS-File auf Disk speichern (OFS) _ 
;- (D0,D2,A0,A1) (Laenge,Mode, Name, Puffer) - 
;- Mode: 0 = Normal, 1 = fortlaufend aa 
;-- weiterspeichern, 2 = Motor ausschalten . 
j;- => DO = Anzahl Bytes , oder O = Error - 
SaveFile: 

move.| dO,f_laenge 

move.| a0,f name 

move.| al,f_puffer 

;- File schließen ? -- 

cmp.w #2,d2 

bne.b sf_ not 

bsr.w sf_close 

moveqg #0,d0 

move.w dO,sf_smode 

rts 
sf_not: 

move.w sf_smode,d7 

move.w d2,sf_smode 

tst.w d7 ; ist Disk in Benutzung ? 
beqg.b sf no_use 

;-- ab hier File in Benutzung --- 

lea sf stapel,a0 

movem.| (a0),23/a5/d5-d6 ; Parameter wiederholen 
move.| f_puffer,a4 

move.| f laenge,d4 

moveq #0,d1 

move.w f_bboffset,dO 

move.w d1,f_bboffset 

cmp.w #488,d0 

beq.w sf_ new3 

move.w dO,f_bboffset 

addq.w #4,d5 

bra.w sf_n_go 


;— ab hier File noch nicht in Benutzung --- 
sf_no_use: 

move.w #1,f first 

moveq #0,d5 

move.| d5,f_gesamtlaenge 
move.w d5,f_bboffset 
move.w d5,sf savebytes 
move.| d5,f_datanr 

bsr.w motoran 

tst.| dO 

beq.b sf_1 

moveq #0,d0 

move.| dO,f gesamtlaenge 
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move.w dO,f_bboffset 
move.w dO,sf_savebytes 
move.| dO,f_datanr 
move.w dO,sf smode 
rts 

— Error -—- 

sf error: 

bsr.w motoraus 

moveq #0,d0 

move.| dO,f gesamtlaenge 
move.w dO,f_bboffset 
move.w dO,sf_savebytes 
move.| dO,f_datanr 
move.w dO,sf smode 
rts 

st_1: 

bsr.w diskprotect 

tst.| dO 

beq.b sf_error 

move.| f diskbitmap,d2 
moveq #6,d1 

move.| #880,d0 

bsr.w loadblock 

tst.| dO 

beq.b sf_error 

move.| dO,a0 

move.| dO,d2 

moveg #2,d] 

move.| 3 16(a0),dO 
move.| dO,f_bitmapnr 
cmp.! #-1,312(a0) 
beg.b sf Oa 

cmp.| #1,312(a0) 

bne.b sf_error 
sf_Oa: 

bsr.w loadblock ; Bitmapblock neu von Disk laden 
tst.| dO 

beq.b sf_error 

bsr.w findsubdir 

move.| a0,dO 

beq.b sf_error 

move.| 500(a0),d1 ; Root/UserDirNr. 
cmp.| #-3,508(a0) Ss1.FILE ? 
beq.b sf nl 

move.| 4(a0),d1 

bne.b sf n] 

move.| #880,d1 
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sf.ni: 

move.| d1,f_parentdir 
lea 24(a0),a2 

move.| f name,a3 
bsr.w gethashblock 
cmp.l #-1,d1 

beq.w sf_error 

tst.! dO 

beqg.b sf_newsave 
sf_search_fileheader: 
moveq #5,d1 

move.| f fileblock,d2 
bsr.w loadblock 

tst.| dO 

beq.w sf_error 
move.| dO,a0 

cmp.| #-3,508(20) 
beq.b sf_sf_ok 
move. #496-24,d1 
move.| 496(a0),dO 
beq.b sf_newsave 
bra.b sf search _fileheader 
sf_sf_ok: 

moveq #0,d0 
move.b 432(a0),dO 
lea 433(a0),a2 

cir.b (a0,dO.w) 
move.| f name,a3 
bsr.w compname 
move.| a0,a5 

tst.| dO 

beq.w sf_oldsave 
move.| #496-24,d1 
move.| 496(a0),dO 
bne.b sf_search_fileheader 


je ab hier File neu abspeichern --- 


laden itel 4 


;A2 = Hashtabelle 
;A3 = Filename 
; Blocknummer zum File suchen 


; Block vom RAM + Check 


; Fileheader laden 


; ST.File ? 


‚ DO 
;A2 


Filenamelaenge 
Disk_Filename 


;A3 = Filename 
; Namen vergleichen 


; sind Namen gleich 


; NextHash_Block 
‚ vorhanden ? 


--- AQ = Root/UserDir, DI = Blockoffset --- 


sf newsave: 

moveq #1,d0 

move. f_diskbitmap,al 
lea 24(a0,d1.w),a2 
move.| d1,-(sp) 

moveqg #-1,d1 

bsr.w getdiskbitmap 
move. (sp)+,d1 
move.| 24(a0,d1.w),d1 


; FileheaderNr. 
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move.| 4(a0),dO 
bne.b sf_nla 
move.w #880,d0 
sf nla: 

move.| d1,-(sp) 
moveq #5,d1 
move.| a0,d2 
bsr.w saveblock ; Root/User bzw. Hashvorgänger abspeichern 
move.| (sp)+,d1 
tst.| dO 

beq.w sf_error 


;— Fileheader neu erstellen --- 
»- DI = Fileheadernr. --- 
move.| dO,a5 

lea 8(a5),a4 

moveq #24,d7 

moveq #0,d6 

sf loopn!: ; Offset 8 bis 508 löschen 
move. d6,(a4)+ 

move.| d6,(a4) + 

move.| d6,(a4)+ 

move.| d6,(a4)+ 

move.| d6,(a4)+ 

dbra d7,sf_loopn 


move.| f parentdir,500(a5) ; ParentDir 
move.|l d1,4(a5) ‚ eigene Nr. 
move.| f laenge,324(a5) ; Filelaenge 


lea 433(a5),a4 
move.| f name,a3 
moveq #29,d6 


moveq #0,d7 

st_loopn2: 

move.b (a3)+ ‚(a4)+ ; Filename eintragen 
addq.w #1,d7 

tst.b (a3) 

beq.b sf_n2a 

dbra d6,sf loopn2 

sf n2a: 

move.b d7,432(a5) ; Filenamelänge 
move.| #2 ‚(a5) ; T.Short 

move.| #-3,508(a5) ; St.File 

sf oldsave: 

move.| #308,d5 ; D5 = Keytableoffset 
cIr.w f_bboffset 

move.| 4(a5),d6 ; D6 = FileheaderNr. 
move.| d6,f_blocknr ; FileheaderBlocknr. retten 
move.| f puffer,a4 ; A4 = Datenquelle 
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move.l| f datablock,a3 ;‚A3 = DataBlock 
move.| f laenge,d4 ; D4 = Datenlänge 
moveqg #0,d1 ; Anzahl Bytes/DataBlock 
move.| #1,8(a3) ;‚ Sequence_start 


move.| d1,8(a5) 


Dee PEN EEE ee TG ee ee ze ee zur zu zu u u ze u ze 


sf_ new3: 

sub.| d1,d4 ‚ schon alle Bytes auf Disk ? 
beq.w sf_ende 

cmp.| #20,d5 ; Blocktable am Ende ? 


bne.w sf_new5 
;- ab hier Blocktable voll (72 Longs) -— 


moveq #1,d7 ;, Extension von Disk laden 
move.| 504(a5),dO ; Extension vorhanden ? 
bne.b sf_n3 

;--- ab hier keine Extension vorhanden -- 

moveq #1,d0 


move.l f_diskbitmap,al 
lea 504(a5),a2 
movem.| d4-d7/a3-a5,-(sp) 


moveq #-1,d1 ; Fileblock 

bsr.w getdiskbitmap ; Extensionblock holen + eintragen 
movem.| (sp) + ‚d4-d7/a3-a5 

tst.! dO 

bne.w sf_error 

move.! 504(a5),dO ; Extensionblock 

moveq #0,d7 ; Extension nicht von Disk laden 

rn ab hier vollen Fileheader- bzw. FileList-Block speichern--- 

st n3: 

movem.| dO/d4-d7/a3-a5,-(sp) 

move.| 4(a5),dO ; Blocknr. 

moveq #13,d1 ; Block in RAM + Check + OldTrackSave 
move.| a5,d2 ; Blockadresse 


bsr.w saveblock 

movem.l (sp) + ‚d1/d4-d7/a3-a5 

tst.| dO 

beq.w sf_error 

;— Abfragen ob FileList von Disk geladen werden soll --- 
cmp.! #1,d7 ; FileListBlock von Disk laden ? 
beq.b sf_n4 

;-- wenn nicht, dann FileListBlock neu anlegen -- 
moveq #24,d7 

lea 8(a5),a2 

moveq #0,d2 
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sf loopn3: ; Offset 8 bist 508 löschen 
move.| d2 (a2) + 

move.| d2,(a2)+ 

move.| d2,(a2)+ 

move.| d2,(a2)+ 

move.| d2,(a2)+ 

dbra d7,sf_loopn3 

move.| #16,(a5) ; T.List 

move.| d1,4(a5) ; eigene Nr. 

move.| d6,500(a5) ; Fileheadernr, 

bra.b sf_n5 

;--- FileListBlock (Extension) von Disk laden --- 

sf nA: 

movem.| d4-d6/a3-a4,-(sp) 

move.| d1,dO 

moveq #13,d1 

move.| a5,d2 

bsr.w loadblock 

movem.| (sp)+ ‚d4-d6/a3-a4 

tst.| dO 

beq.w sf_error 

move.| dO,a5 

Ba #0 ,8(a5) ; Keytablezähler auf null 
st n5: 

move.| #308,d5 ; Keytableoffset_start 


;- ab hier Data-Block bearbeiten --- 

sf_ new: 

move.| (a5,d5.w),dO ; Datablocknr. holen 
bne.b sf_n6 ; vorhanden ? 

;--- wenn nicht, dann Datablock zuweisen lassen -- 
movem.| d4-d6/a3-a5,-(sp) 

moveq #1,d0 

move. f_diskbitmap,a 

lea (a5,d5.w),a2 ; Blockpuffer 

moveq #0,d1 ; Typ = DataBlock 
tst.w f first ; erster Datenblock ? 
beq.b sf_n66 

moveqg #-1,d1 ; dann Typ = FileBLock 
cIr.w f first 

sf_n66: 

bsr.w getdiskbitmap ; Blocknr holen und setzen 
movem.| (sp)+ ‚d4-d6/a3-a5 

tst.| dO 

bne.w sf_ error 


’ 
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;- ab hier DataBlock in A3 -- 

sf_n6: 

cmp.| #16,(a5) ; T.List ? 

beq.b sf_n6aa 

move.| 308(a5),16(a5) ; FirstBlock in Fileheader eintragen 
sf nbaa 

tst.w sf savebytes ; schon Bytes auf Disk gespeichert ? 
beq.b st_n7 

;-- wenn ja, dann vorherigen DataBlock abspeichern --- 

move. (a5,d5.w),16(a3) ; NextBlock 

movem.| d4-d6/a3-a5,-(sp) 

moveq #13,d1 

move.| a3,d2 

move.| f_datanr,dO 

bsr.w saveblock 

movem.l (sp)+ ‚d4-d6/a3-a5 

tst.| dO 

beq.w sf_error 

adda.! #1,8(a3) 


je DataBlock anlegen --- 


st n?: 

adda.! #1,8(a5) ; Blocktablezähler + 1 
move.| (a5,d5.w),f_datanr ; für abspeichern 

move.| #8,(a3) ; T.Data 

move.| d6,4(a3) ; FileNr. 

sf_n_go: 

moveq #0,d3 

move.| d3,16(a3) ; NextBlock 

move.w f_bboffset,d3 ; Byteoffset 

clr.w f_bboffset 

move.| #488,12(a3) ; Anzahl Bytes im Datablock 
move.| d4,d2 ; Anzahl aller Bytes 

add.! d3,d2 ; + Byteoffset (0 bis 488) 
cmp.| #488,d2 ‚> 488 ? 

bhi.b sf_n8a 

move.| d2,12(a3) ; wenn nicht, Datenanzahl eintragen 


sf n8a: 


;--- Datenbytes in DataBlock kopieren -- 


move. 12(a3),dO ;, Datenanzahl 

sub.! d3,dO ‚ - Byteoffset (0 bis 488) 

move.| dO,d1 ;‚ DI = Anzahl Datenbytes 
subq.w #1,d0 ; DO = Loopzähler 

lea 24(a3,d3.w),a2 ; Anfang (Datablock + Byteoffset) 
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sf_loopn8b: 

move.b (a4)+ ‚(a2)+ ; Datenbytes kopieren 
dbra dO,sf_loopn8b 

move.w #1,sf_savebytes 

subq.w #4,d5 ; KeytableOffset - 4 
bra.w sf new3 


;-- ab hier Data/Fileblock abspeichern und evtl. Blocks --- 
;— freigeben und Bitmapblock abspeichern --- 

sf_ ende: 

move.w 14(a3),f_bboffset ; letzte Bytelänge speichern 
lea sf_stapel,a0 

movem.| a3/a5/d5-d6,(a0) 

move.| f laenge,dO 

add.| dO,f gesamtlaenge 

tst.w sf_smode 

beq.b sf_close 

rts 


;— File schliessen --- 


sf_ dose: 
lea sf_stapel,a0 
movem.| (a0),a3/a5/d5-d6 ; Parameter wiederholen 


;-- ab hier letzten Datablock abspeichern -- 

movem.| d5/a5,-(sp) 

moveq #13,d1 

move.| f datanr,dO 

move.l a3,d2 

bsr.w saveblock ; Datablock abspeichern 
movem.| (sp)+ ‚d5/a5 

tst.| dO 

beq.w sf_error 

;- ab hier alle evtl. noch vorhandenen Data-Blöcke 

;- im FileList/Fileheaderblock freigeben - 


move.| f diskbitmap,al ; DiskBitmap-Block 
lea (a5,d5.w),a2 ; Keytableanfang 
sub.w #20,d5 ;‚ Anzahl DataBlöcke 
Isr.w #2,d5 ; ermitteln 

beq.b sf e1 ; keine ? 

cmp.| #0,(a2) 

beg.b sf el 

move.| d5,dO ; Anzahl Datablöcke 
movem.| d0/a5/a2,-(sp) 

bsr.w freediskbitmap ; und freigeben 
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movem.| (sp)+ ‚dO/a5/a2 

addq.w #4,a2 

subq.w #1,d0 

moveq #0,d1 

sf loope!: ; DataBlocknr. in File-Block löschen 
move.| d1,-(a2) 

dbra dO,sf_loope] 


st ei: 

move.| 504(a5),d7 ‚ Extension vorhanden ? 
beq.b sf_e2 ; wenn nicht, dann weiter 
movem.| a5/d7,-(sp) 

moveq #1,d0 ; 1 Extensionblock 


move.| f_diskbitmap,a 
lea 504(a5),a2 


bsr.w freediskbitmap ; und freigeben 

movem.! (sp)+ ,a5/d7 

cIr.| 504(a5) ; Extension in FileBlock löschen 
;—- fertigen Fileblock abspeichern --- 

sf_e2: 

movem.| a5/d7,-(sp) ; Fileblock und Extensionnr. retten 


moveq #14,d1 

move.| 4(a5),dO 

move.| a5,d2 

bsr.w saveblock ; Fileblock speichern 
movem.| (sp) + ,a5/d7 

tst.| dO 

beq.w sf_error 


in abfragen ob Extension vorhanden ist -- 
tst.| d7 
beq.b sf_e end 


;—- ab hier alle Extensionblöcke mit Datablöcke freigeben --- 
sf_loope2: 

move.| d7,dO ; Fileblocknr. 

moveq #5,d1 

move.| a5,d2 

bsr.w loadblock ; Filelistblock laden 
move.| dO,a5 

tst.! dO 

beq.w sf_error 

move.| 8(a5),dO ; Anzahl Datablöcke 
lea er ; Keytablestart 

move.| f diskbitmap,al 

move.| a5,-(sp) 

bsr.w freediskbitmap ; und Blöcke freigeben 
move.| (sp)+ ‚a5 
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move.| 504(a5),d7? ; weiterer Extension vorhanden ? 
beq.b sf e end 

movem.| d7/a5,-(sp) 

lea 504(a5),a2 

move.| f diskbitmap,al 

moveq #1,d0 

bsr.w freediskbitmap ; Extension freigeben 

movem.l (sp)+ ‚d7/a5 

bra.b sf_loope2 


;- ab hier Bitmapblock abspeichern --- 

st e end: 

move.l f_diskbitmap,al 

move.| a1,a0 

moveq #$71,d1 

moveq #0,d0 

move.| dO,(al) 

sf loop_check: ; BitMapchecksumme berechnen 
sub.| (a0) + ,dO 

dbf di,sf loop _check 

move. dO,(a1) ; und eintragen 

move.| al,d2 

moveq #1,d1 

move.| f_ bitmapnr,dO 

bsr.w saveblock ; BitMapblock speichern 
tst.| dO 

beq.w sf_error 


;-- neue Filelänge in Fileheader eintragen + abspeichern --- 
move.| f fileblock,d2 

move.| f blocknr,dO 

moveq #13,d1 

bsr.w loadblock 

tst.! dO 

beqg.w sf_error 

move.| dO,a0 

move.| f gesamtlaenge, 324(a0) ; Filelänge eintragen 
move.| dO,d2 

moveqg #14,d1 

move.| 4(a0),dO 

bsr.w saveblock 

tst.| dO 

beq.w sf_error 

bsr.w motoraus 

cIr.w sf_ smode 

move.| f laenge,dO 

rts 
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sf_savebytes: 
sf_stapel: 
f_gesamtlaenge: 


’ 


;-- Gesammte u. Data-Blocklänge ermitteln 


;— DO = Filelänge 


;- Rück in DO = gesammte Blocklänge 


n Di 


4 


dc.w O 
bik.| 4,0 
dc.I 0 


;-- Rück in DI = Gesammte DataBlocklänge 2 


FileBlockLaenge: 
divu #488,d0 
move.w dO,d1 
swap dO 

tst.w dO 

beq.b fileblock_a 
addq.w #1,d1 
fileblock_a: 

ext. di 

move.| d1,dO 
divu #72,dO 
move.w dO,d2 
swap dO 

tst.w dO 

beaq.b fileblock_b 
addqa.w #1,d2 
fileblock_b: 
add.w d1,d2 
move.w d2,dO 
ext.| dO 

rts 


;- Gibt Blocks in der BitMap wieder frei 


;- A2 = Blocktabelle, 
> Al = Bitmapblock 
FreeDiskBitmap: 
adda.w #4,al 
addq.w #4,a2 
addqa.w #1,d0 
fdb_loop: 

subg.w #1,d0 

beq.b fdb_end 
move. -(a2),d3 
beqg.b fdb_end 
subq.! #2,d3 

move. d3,d1 

Isr.w #5,d3 

add.w d3,d3 

add.w d3,d3 

and.! #31,d1 


; DataBlocklänge = 488 Bytes 
; Anzahl DataBlöcke 


; Rest vorhanden ? 


;D1 = Anzahl DataBlöcke 


; Anzahl FileHeader/List-Blöcke ermitteln 


;D2 = Anzahl Fileblöcke 


; DO = gesammte Anzahl Blöcke 


DO = Anzahl Blöcke -- 


; Al = Bitmapadresse nach Checksumme 


; Block holen 

; Blöcke und O und 1 überspringen 
; Blocknummer retten 

; BlockNr. / 32 = Longoffset 


; LongOffset * 
; Bitposition herausfinden 
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moveq #0,d2 
bset d1,d2 

or.| d2,(al,d3.w) 
bra.b fdb_loop 
fdb_end: 

rts 


; Bit setzen (Block jetzt frei) 


;--- Belegt bestimmte Anzahl Blocks in der DiskBitMap 

;-- DO = Anzahl Blöcke; DI = Art (0 = Data, -1 = File) 

;—- A2 = Blockpuffer; Al = BitMapBlock 2 
;- Rück in DO = O0, dann OK ; -] = Fehler - 


GetDiskBitmap: 
tst.w dO 

beq.w gdb end 
addqa.w #4,a2 
addq.w #4,a1 
move.| #1760,d7 
tst.w d] 

bne.b gdb file 
gdb_data: 

move.| #869,d2 
gdb_loop!: 
moveq #10,d6 
gdb _loop2: 
move.| d2,d3 
subq.w #2,d3 
bmi.b gdb file 
move.| d3,d4 
Isr.w #5,d3 
add.w d3,d3 
add.w d3,d3 
and.| #31,d4 
move.| (a1,d3.w),d5 
btst d4,d5 

beg.b gdb_I2a 
move.| d2,-(a2) 
moveq #-1,d5 
belr d4,d5 

and.| d5,(al,d3.w) 
subq.w #1,d0 
beq.b gdb_end 
gdb 12a: 

subq.w #1,d7 
beq.b gdb error 
addq.w #1,d2 
dbra d6,gdb _loop2 


; Al = Bitmapadresse nach Checksumme 
; Loopzähler (1760 Blöcke) 


‚ StartBlock für DataBlocks 


; Sektorenzähler 


; Blocknummer retten 
; BlockNr. / 32 = Longoffset 


; LongOffset * 4 
; Bitposition herausfinden 


; Block noch frei ? 


; Blocknr in Tabelle eintragen 


; Blocknr. +1 
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sub.w #22,d2 
bpl.b gdb loop! 
gdb file: 

move.| #880,d2 
gdb_loop11: 
moveq #10,d6 
gdb_loop22: 
move.| d2,d3 
subq.w #2,d 
move.| d3,d4 
Isr.w #5,d3 
add.w d3,d3 
add.w d3,d3 
and.| #31,d4 
move.l (a1,d3.w),d5 
btst d4,d5 

beq.b gdb_l22a 
move.l d2,-(a2) 
moveq #-1,d5 
beIr d4,d5 

and.| d5,(al,d3.w) 
subq.w #1,d0 
beq.b gdb_end 
gdb_I122a: 
subq.w #1,d7 
beq.b gdb_error 
addq.w #1,d2 
dbra d6,gdb_loop22 
cmp.w #1749,d2 
bls.b gdb _loop11 
bra.w gdb_data 
gdb_error: 

moveq #-1,d0 
gdb end: 

rts 
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; StartBlock für FileBlocks 


‚ Sektorenzähler 


‚ Blocknummer retten 
; BlockNr. / 32 = Longoffset 


; LongOffset * 4 
; Bitposition herausfinden 


; Block noch frei ? 


; Blocknr in Tabelle eintragen 


; Blocknr. +1 


;-- gucken on genug Blöcke auf Disk frei -- 
;-- DO = Anzahl Blöcke; Al = BitMapBlock -- 
> Rück in DO = 0, dann OK; -1 = Fehler --- 


LookDiskBitmap: 
tst.w dO 

bne.b Idb_1 
Idb_end: 

rts 

Idb_1: 

adda.! #4,a1 
moveq #55,d3 
Idb_loop: 


; Al = Bitmapadresse nach Checksumme 
Anzahl Longwords in Bitmap (1758 Blöcke) 
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move.| (al)+,d4 ; 32 Blocknummer holen 
beq.b Idb full ; schon alle belegt ? 
moveq #0,d2 ; Anfangen bei Bit O 
Idb_test: 

btst d2,d4 ; Bit gesetzt ? 

beq.b Idb full] 

subq.w #1,d0 ; Blockzähler -1 
beq.b Idb_end 

Idb full?: 

addq.w #1,d2 

cmp.w #32,d2 

bne.b Idb_test 

Idb_full: 

dbra d3,Idb loop 

moveq #-1,d0 

rts 


4.2 Unterroutinen zum Datentransfer 


Jetzt fehlen noch einige Hilfsroutinen, auf denen die Funktionen 
LoadFile () und SaveFile zugreifen. Zum Beispiel für die Hash- 
Berechnung, umwandeln des Filenames in Groß-ASCII usw. 


;-- Userdirs durchsuchen nach Fileheader-Block 
;- f name = Filename 

- => AO = 0 für Fehler, sonst UserDir/RootBlock-Adresse 
;- => f name = Real FileNameadresse (ohne Subdirs) 
FindSubbDir: 


move.| #880,d0 ; RootBlock 

moveq #6,d1 ; Block neu von Disk + Check 
move.l f fileblock,d2 

bsr.w loadblock ; Block laden 

tst.| dO ; konnte Block geladen werden 
beq.b findsub_error 

move.| dO,a0 

cmp.| #2,(a0) ; TShort ? 

bne.b findsub_error 

cmp.! #1,508(a0) ; ST.Root ? 

bne.b findsub_error ; AD = RootBlockadresse 


findsub_findnext: 

bsr.b findsubdirname 

tst.| dO 

beq.b findsub_ok ; Letztes SubDir gefunden 
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cmp.| #-1,d0 

beq.b findsub_error 

lea 24(a0),a2 ;‚ A2 = HashTable 
move.| fsn_name,a3 

bsr.w gethashblock ; Hashoffset berechnen 
tst.| dO 

beq.b findsub_error 


findsub_nextuser: 

moveq #5,d1 ; Block von RAM + Check 
move.l f_fileblock,d2 

bsr.w loadblock ; UserDir laden 
tst.| dO 

beq.b findsub_error 

move.| dO,a0 

cmp.| #2,508(a0) ; St.UserDir ? 
beq.b findsub_ud 

move.| 496(a0),dO ; NextHash 
beq.b findsub_error 

bra.b findsub_nextuser 


findsub_ud: 


move.| fsn_name,a3 

lea 432(a0),a2 ; UserDirName 
moveqg #0,dO 

move.b (a2)+,dO ; Namelänge 


cIr.b (a2,dO.w) 

bsr.w compname 

tst.| dO 

beq.b findsub_findnext 

move.| 496(a0),dO ; NextHash ? 
bne.b findsub_nextuser 

findsub_error: 

sub.| a0,a0 ; AO = 0 für Error 
findsub_ok: 

rts 


;—- Namen bis "/" suchen für Unterdirectories -- 
; f name = Filename = 


— =2>D00=0 dann kein SUBDIR mehr; 

— sonst Filename mit Subdirs . 
ji -1 = Error ” 
je => fsn name = Zeiger auf SUBDIR_Name/ File) -- 
Findsubdirname: 


lea subname,al 
move. f_name,a2 
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tst.b (a2) 

beq.b fsn_error 
moveq #0,d0 
fsn_loop: 

move.b (a2)+ ‚(al)+ 
cmp.b #"/" (a2) 
beq.b fsn_ok 
addq.w #1,d0 
cmp.w #31,d0 
beq.b fsn_error 
cmp.b #0,(a2) 
bne.b fsn_loop 
moveq #0,d0 

rts 

fsn_ok: 

cir.b (al) ; SUBDir_ Name mit Null enden 
move.| a2,dO 
addaq.| #1,d0 
move.| dO,f_ name 
rts 

fsn_error: 

moveqg #-1,d0 

rts 


subname: bik.b 82,0 
fsn_name: dc.| subname 


;—- zwei Namen miteinander vergleichen 
;-- (A2/A3/DO) (Name1,Name2,Laenge) 
;- Rueck: DO = O0 dann ok, -1 = Error 
CompName: 

subq.w #1,d0 

move.| a3,a4 

cn loop: 

move.b (a2)+ ,d2 

bsr.b bigascıi 

move.b d2,d1 

move.b (a4)+ ,d2 

bsr.b bigascii 

cmp.b d2,dI 

bne.b cn_error 

dbra dO,cn go 

tst.b (a4) 

bne cn_error 

tst.b (a2) 

bne cn _error 
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moveq #0,d0 
rts 

cn_go: 

tst.b (a4) 
beq.b cn_error 
tst.b (a2) 
bne.b cn _loop 
cn _error: 
moveq #-1,d0 
rts 


;— Filename in HashOffset umwandeln ._ 


;— (A2,A3) (Hashtable,Filename) 


„—- => DO = Blocknr. oder O = Error u 


—- => D1 = Hashoffset oder -1 = Error 
GetHashBlock: 

move.l a3,a4 

moveq #0,d0 

moveq #29,d1 ; maximal 30 Zeichen 
ghb_name: 

tst.b (a4)+ 

beq.b ghb_1 

addqa.w #1,d0 

dbra d1,9ghb_name 

moveq #-1,d1 

ghb_error: 

moveq #0,d0 

rts 

ghb_1: 

move.l dO,d1 

subq.w #1,d1 

moveq #0,d2 

move. a3,a4 


ghb_offset_loop: 

mulu #13,d0 

move.b (a4)+,d2 

bsr.b bigascıi 

add.! d2,dO 

and.w #$7ff,dO 

dbra d1,ghb_offset_loop 
divu #72,d0 

swap dO 

add.w dO,dO 

add.w dO,dO 

move.w dO,d1 ; Hashoffset 
move.| (a2,d0.w),dO 
beq.b ghb_error 
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cmp.w #1759,d0 
bhi.b ghb error 


rts 

;-- ein ASCII zeichen umwandeln in Gross-ASCII 
- D2 = ASCII-Wert 

;-- Rueckgabe in D2 = NEW ASCII 

BigAscit: 

cmp.b #"ä",d2 


beq.b bigascii_ a 
cmp.b #"6",d2 
beq.b bigascii_a 
cmp.b #"ü",d2 
beq.b bigascıi_a 
cmp.b #"a",d2 
blt.b bigAscii_end 
cmp.b #"z",d2 
bgt.b bigAscii_ end 


bigascii_a: 

sub.b #$20,d2 
bigAscii_end: 

rts 

i-- Parameter -- 

f parentdir: dc.|O 
sf_smode: dc.w O 
f smode: dc.w O 
f laenge: dc.1 0 
f_offset: dc.1 0 
f name: dc.| 0 
f_puffer: dc.| O0 


f zaehler: dc.1 0 
f bboffset:  de.w O 
f fileblock:  de.l 0 
f datablock: dc.l O 
f diskbitmap: dc.| O 
f bitmapnr: dc.!O 
f datanr: dc.| O 
f oldsame: dce.w O 
f first: dc.w O 
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5. Das Trackdisk-Device 


Die Devices sind eine der großen Stärken im Amiga. Dabei handelt es 
sich um Programmpackete über die es sehr einfach ist, ohne Umge- 
hung des Multitasking, bestimmte Geräte wie Diskettenlaufwerk, 
Festplatte, Drucker usw. anzusteuern. 


Die Grundstruktur eines Devices ist immer dieselbe, nur die Funktion- 
en sind unterschiedlich und evtl. kommt noch eine Erweiterung der 
Basisstruktur hinzu. 


Das es sich bei den Devices um eigenständige Programme handelt, 
müssen wir einen Weg vorbereiten, um mit denen kommunizieren zu 
können. Dies geschieht über einen Message-Port. Dazu benötigen wir 
die Adresse des eigenen Task, die wir über die Exec-Funktion 
"FindTask ()" erhalten, der wir in Al eine Null übergeben (für 
eigenen Task). Jetzt müssen wir nur noch einen Antwort-Port (Reply- 
Port) anlegen, wo wir die Adresse von unserem Task eintragen und 
anschließend den Port dem System über die Funktion "AddPort ()" 
zufügen. Als letztes öffnen wir das gewünschte Device mit der 
Funktion "Open-Device ()". In Al muß die Adresse der Standard- 
DevicelO-Struktur für die Kommandos übergeben werden. 


Zur Übersicht das Ganze nochmal in Kurzform: 
1) FindTask (A1) 

Al=0 

=> DO = eigene Taskadresse 


2) eigene Taskadresse in ReplyPort (Offset 16) eintragen 


3) AddPort (A1) 
A1 = ReplyPort-Adresse (Puffer von 34 Bytes) 
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4) OpenDevice (A1,AO,D0,D1) 


AO = Zeiger auf DeviceName 

Al = Zeiger auf DevicelO-Struktur (Puffer v. mind. 48 Bytes) 
Di = Flags (meistens Null) 

DO = Unit (Abhängig vom Device) 


=> DO = 0, dann konnte Device geöffnet werden, sonst Fehler 
5) ReplyPort in DevicelO-Struktur eintragen (Offset 14) 


Um ein Device wieder freizugeben (bei Beendigung des Program- 
mes), muß der ReplyPort entfernt und das Device geschlossen 
werden. 


1) RemPort (A1) 
Al = Adresse des ReplyPorts 
2) CloseDevice (A1) 
Al = Zeiger auf DevicelO-Struktur 


Eine Basis-DevicelO-Struktur besteht aus drei Strukturen, die hinterein- 
ander im Speicher liegen müssen. Es handelt sich dabei um die 


- MsgNode-Struktur (20 Bytes) 
- JOPxt-Struktur (12 Bytes) 
- /OStdlExt-Struktur (16 Bytes) 


Als Basis-DevicelO-Struktur sieht das folgendermaßen aus: 


Typ N Funkti 
00 L Succ Adresse der nachfolgenden MsgNode-Struktur oder Null 
04  L Pred Adresse der vorherigen MsgNode-Struktur oder Null 
08 B Type Eintragstyp (hier NT_Device => 3) 
09 B Ph Priorität dieser Struktur 
10 L Name Zeiger auf Namen dieser Struktur 
14  L ReplyPort Adresse des ReplyPorts (selber eintragen) 


18 \W MNLength Länge der folgenden Message-Daten (38 Bytes) 


..—— —— ||, | min n nn nu namen nn nen nt nn une EEE EEE m EEE ne nn nn nn nn mn nn nn nenn 


20  L 1IO Device Zeiger auf DeviceNode (wird durch OpenDevice () eingetr.) 
24  L IO Unit Einheitsnummer (Abhängig vom Device) 
28 \W IO Command Befehl für das Device 
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30 B IO Flags Flags (Abhängig vom Device) 
31 B IO Error Error-Rückmeldung nach der Durchführung eines Befehls 


.———————————m——unnnunnn nenn snunmnmnmunm nn nn mnnne nn nun men nn nm nn nen mnnn nun nun mu—n nn nn nnn nen mn nn nen mn nn nu munn nn sn nn nn nn n 


L IO Actual Anzahl der tatsächlich übertragenden Bytes vom Device 
36 L 1IO Length Anzahl der zu übertragenden Bytes 
L IO_Data Adresse des Speicherbereichs, wo die Daten vom Device 
gespeichert werden sollen 
44 L IO Offset Datenoffset (Abhängig vom Device) 


48 Hier beginnt evtl. eine Erweiterung der Struktur (Abhängig vom Device und 
den Befehlen) oder die Struktur ist hier zuende. 


Die Strukturen können natürlich auch mit den entsprechenden Exec- 
Funktionen angelegt werden, doch als Assemblerprogrammierer 
können wir diese leichter selbst anlegen. 


Zu jeder Basis-DevicelO-Struktur gehören auch bestimmte Basis- 
Befehle: 


Basi hle eines Device: 


F 
CMD Invalid ungültiges Kommando 
CMD Reset Device zurücksetzen auf Anfangszustand 


) 
1 
CMD Read 2 Device ließt Daten in den Datenpuffer (IO_Data) 
CMD Write 3 Device schreibt die Daten auf die IO_Data zeigt auf das ent- 
sprechende Gerät 
CMD Update 4 restaurieren des Datenpuffers 
CMD Clear 5 Datenpuffer löschen 
CMD Stop 6 letzten Device-Befehl anhalten 
CMD Start 7 Device-Befehl wieder fortsetzen 
CMD Flush 8 Abbruch des letzten Device-Befehls 


„m. ——.— ||| nm u—mnnnnnnsnnmnnnsnumnnnnmnnn un nnn=nrnmm nn nennen nen innen en nn nnnm— une men nn n— mm nn nen men nennen nme nn ne mn nn nn nn nenn nun 


Es gibt in Abhängigkeit des jeweiligen Device noch einige zusätzliche 
Befehle. Auf diese gehen wir in den entsprechenden Abschnitten ein. 
Mehr Informationen über die Device-Struktur finden Sie im Kapitel 
13. 
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5.1 Funktionen des Trackdisk-Device 


Nachdem wir die Programmierung des Diskettenlaufwerks über die 
Hardware bis ins kleinste Detail besprochen haben, folgt jetzt eine 
Möglich-keit dieses erheblich komfortabler zu erledigen. Dafür stellt 
uns das System das Trackdisk-Device zur Verfügung. Alle Funktionen 
die wir vorher umständlich selber entwickelt haben, können wir jetzt 
einfach durch bestimmte Kommandos über das Trackdisk-Device 
ausführen. 


Geöffnet wird das Trackdisk-Device mit der Funktion "OpenDevice ()". 
Als Unit (DO) kann ein Wert zwischen O und 3 übergeben werden, 
der einem bestimmten Laufwerk entspricht (DFO bis DF3). Setzt man 
für Flags (D1) eine Null, so wird jedes Laufwerk zugelassen, egal ob 
3,5 oder 5,25. Möchte man gezielt ein bestimmtes Flag zulassen, so 
sind folgenden Werte für Flags (D1) zulässig: 


Wert Name Funktion 
Alle Laufwerke zulassen 
1 DRIVE3 5 Nur 3,5 Laufwerke zulassen 
2  DRIVES 25 Nur 5,25 Laufwerke zulassen 


3  DRIVE3 5 150RPM Nur 3,5 Laufwerke mit bestimmter Geschwindigkeit 


Das Trackdisk-Device besteht aus einer normalen Basis-DevicelO- 
Struktur, wie vorher beschrieben. Allerdings stehen jetzt ein paar 
Befehle (Commands) mehr zur Auswahl. Welche Kommandos es gibt 
und welche Funktionen sie beinhalten, beschreibt folgende Tabelle: 


Seite 310 


Das Trackdisk- 


Commands (Offset 28) für das Trackdisk-Device: 


CMD_READ 
CMD_ WRITE 
CMD_UPDATE 
CMD CLEAR 


Sektoren lesen zu 512 Bytes 

Sektoren schreiben zu 512 Bytes 
Trackpuffer auf Diskette zurückschreiben 
Trackpuffer als ungültig erklären 


.m_—— — m | mu anunhsmuunemesnahm—uunnm—nnnun—nn num nn nn mm ano nun nn nmnn nm nn nn nn mn nn nd nu nun nimm nn nn nn mn nn nn oene u nnnnunnm 


TD_MOTOR 
TD_SEEK 
TD_FORMAT 
TD_Remove 
TD_CHANGENUM 
TD_CHANGESTATE 
TD_PROTSTATUS 
TD_RAWREAD 
TD_RAWWRITE 
TD_GETDRIVETYPE 
TD_GETNUMTRACKS 
TD_ADDCHANGEINT 
TD_REMCHANGEINT 
TD_GETGEOMETRY 


TD_EJECT 
TD _LASTCOMM 


Diskmotor ein-/ausschalten 

Schreib-/Lesekopf bewegen 

ein oder mehrere Tracks formatieren 
Interrupt-Funktion (ab 2.0 keine Funktion mehr) 
Anzahl der Diskettenwechsel ermitteln 

Testen ob Diskette im Laufwerk liegt 

Testen ob Diskette schreibgeschützt ist 

Track im RAW-Zustand (MFM/GCR) lesen 

Track im RAW-Zustand (MFM/GCR) schreiben 
angeschlossenen Laufwerkstyp feststellen (3,5/5,25) 
Anzahl der Tracks auf Diskette ermitteln 
Diskettenwechsel-Interrupt ins System einbinden 
Diskettenwechsel-Interrupt aus System entfernen 
Informationen über das angeschlossenen Laufwerk 
einlesen (erst ab Kickstart 2.0 / V36) 

neues Medium einbinden (ab Kickstart 2.0 / V36) 
kennzeichnet das Ende der Liste (hier 24= >40) 


| EEE TE EEE EEE EEE ET nn nun nn nun nn nn 


Das Kommando (Wert) wird in der DevicelO-Struktur ab Offset 28 
(IO_Commands) eingetragen. Welche Auswirkung der Befehl genau 
hat und welche Parameter er noch zusätzlich benötigt folgt in den 
Beschreibungen der einzelnen Befehle. 


Command: CMD_READ (2) 


Ließ ein oder mehrere Sektoren vom Trackpuffer in den Datenpuffer 
auf den IO Data zeigt. Die Anzahl muß ein vielfaches von 512 sein 
(IO_ Length = 1, dann 512 Bytes). Befindet sich der Track noch im 
Speicher werden die Daten von dort eingelesen. Muß ein neuer Track 
geladen werden, so wird der alte, sofern Änderungen vorgenommen 
wurden, erst auf die Diskette zurückgeschrieben. 
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IO Command = CMD_READ 
IO Length = Anzahl der Blöcke (vielfaches von 512) 
IO Offset = Blocknummer ab dem gelesen werden soll 
(Offset = Blocknummer (0 bis 1759) x 512) 
IO Error = Fehlernummer oder Null für alles OK 
IO Data = Adresse des Datenpuffers, wo die Blöcke hingeladen werden sollen 


(ab Kickstart 2.0 (V36) darf der Puffer auch im Fast-Memory liegen, 
sonst muß dieser im CHIP-Memory liegen) 


Command: CMD WRITE (3) 


Schreibt ein oder mehrere Sektoren (lO Length in Bytes) auf die 
IO_Data zeigt in den Trackpuffer. 


IO Command = CMD_WRITE 

IO Length = Anzahl der Blöcke (vielfaches von 512) 

IO Offset = Blocknummer ab dem gespeichert werden soll 
(Offset = Blocknummer (0 bis 1759) x 512) 

IO Error Fehlernummer oder Null für alles OK 


IO Data = Adresse des Datenpuffers, der die Blöcke enthält 
(ab Kickstart 2.0 (V36) darf der Puffer auch im Fast-Memory liegen, 
sonst muß dieser im CHIP-Memory liegen) 


Command: CMD UPDATE (4) 


Sektoren (Blöcke) werden immer im Trackpuffer zwischengespeichert. 
Erst wenn sich die Tracknummer ändert, wird der alte Track auf 
Diskette geschrieben und auch nur dann, wenn Veränderungen 
vorgenommen wurden. Mit diesem Kommando kann man das Device 
dazu bringen, daß der aktuelle Trackpuffer sofort auf die Diskette 
geschrieben wird. 


IO Command 
IO_Error 


CMD UPDATE 
Fehlernummer oder Null für alles OK 
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Command: CMD_ CLEAR (5) 


Der aktuelle Trackpuffer wird für ungültig erklärt. Beim nächsten 
Lesebefehl (CMD_READ) wird der Track neu von der Diskette gelesen. 


CMD_CLEAR 


IO Command $4 
Fehlernummer oder Null für alles OK 


IO_Error 


Command: TD_MOTOR (9) 


Ein- oder Ausschalten des Laufwerkmotors. 


IO Command = TD_MOTOR 
IO Length = (=Motor ausschalten oder 1=Motor einschalten 
IO Error = Fehlernummer oder Null für alles OK 


Command: TD SEEK (10) 


Schreib-/Lesekopf auf den Track positionieren, der in IO Offset 
angegeben wurde. 


IO Command = TD _SEEK 
IO_Offset = Trackoffset => Tracknummer (0-159) x TrackSize (11x512=5632) 
IO Error = Fehlernummer oder Null für alles OK 


Command: TD_FORMAT (11 


Formatieren eines oder mehrerer Tracks. 


IO Command = TD_FORMAT 
IO Offset = Trackoffset => Tracknummer (0-159) x TrackSize (5632) 
IO Length = Länge in Tracks (5632xTrackanzahl) 
IO Data = Adresse des Trackpuffers in der Länge von IO Length 
(ab Kickstart 2.0/V36 darf dieser Puffer auch im Fast-Memory liegen) 
IO_Error = Fehlernummer oder Null für alles OK 
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Command: TD_REMOVE (12) 


Über diesen Befehl kann man ein Interrupt an die Systemliste 
hängen, der immer beim Herausziehen der Diskette aktiviert wird. 
Dieses Kommando wird allerdings nicht mehr ab Kickstart 2.0 
beschrieben. Dafür gibt es die Befehle "TD_ADDCHANGEINT und 
TD_REMCHANGEINT". Möchte man trotzdem auf diese Funktion 
zugreifen, so muß noch eine zweite DeviceExtIO-Struktur angelegt 
werden. Zum Entfernen des Interrupts muß man IO Data auf Null 
setzen und das Kommando TD_Remove nochmal ausführen. 


IO Command = TD_REMOVE 
IO Data = Adresse der eigenen Interrupt-Struktur oder Null zum Entfernen 
IO Error = Fehlernummer oder Null für alles OK 


Command: TD_CHANGENUM (13) 


Anzahl der Diskettenwechsel ermitteln (wie oft eine Diskette in das 
Laufwerk gelegt wurde). 


IO Command = TD_CHANGENUM 
IO_Error = Fehlernummer oder Null für alles OK 
IO Actual = wenn IO Error = 0, dann steht hier die Anzahl Diskettenwechsel 


Command: TD_CHANGESTATE (14) 


Dieser Befehl testet, ob sich eine Diskette im Laufwerk befindet. 


IO Command = TD_CHANGESTATE 
IO_Error = Fehlernummer oder Null für alles OK 
IO Actual = wenn IO Error = 0, dann steht hier eine Null für Diskette im 


Laufwerk oder ungleich Null für keine Diskette im Laufwerk 
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Command: TD_PROSTATUS (15) 


Abfragen, ob eine Diskette im Laufwerk schreibgeschützt ist. 


IO Command = TD_PROSTATUS 

IO Error = Fehlernummer oder Null für alles OK 

IO Actual = wenn IO Error = 0, dann steht hier eine Null für Diskette nicht 
schreibgeschützt oder ungleich Null für schreibgeschützt 


Command: TD_RAWREAD (16) 


Es wird nur ein einziger Track im MFM- oder GCR-Format (siehe 
Kapitel 2) nach IO_Data geladen. Dabei kann auch auf eine Sync- 
bzw. Indexmakierung gewartet werden (erst ab V36). Die Länge 
(IO_Length) darf maximal 32 KBytes betragen und der Datenpuffer 
muß im CHIP-RAM liegen, weil der Controller die Daten direkt dort 
ablegt (keine Aufbereitung durch das System). Wird auf den Index- 
Impuls gewartet, können in den ersten 135 und den letzten 200 
microsekunden, aufgrund der Amigahardware, keine Bits gelesen 
werden, wodurch das erste Sync-Word ($4489) und die letzten 4 bis 
7 Bytes verloren gehen. 


IO Command = TD_RAWREAD 
IO Flags = Null, wenn die Daten einfach uncodiert (evtl. verschoben) eingelesen 
werden sollen (bis Kickstart 2.04 / V36) 
= IOTF_INDEXSYNC (Bit 4 =1), wenn vor dem Lesen auf den 
Index-Impuls gewartet werden soll (ab V36) 
= IOTF_WORDSYNC (Bit 5 =1), wenn vor dem Lesen auf den das Sync- 
Word $4489 gewartet werden soll (ab V36) 
IO Length = Länge in Bytes, die gelesen werden sollen (max. 32768 Bytes) 
IO Data = Adresse des Datenpuffers, wo die Daten abgelegt werden soll (muß 
im CHIP-RAM liegen) 
IO_Offset = Trackoffset => Tracknummer (0-159) x TrackSize (5632) ab dem der 
Track gelesen werden soll 
IO_Error = Fehlernummer oder Null für alles OK 
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Command: TD_RAWWRITE (17) 


Einen codierten Track auf Diskette schreiben. Wichtig ist, daß zuerst 
die Tracklücke und dann der eingentliche Track (s. Kapitel 2) 
geschrieben wird. Das Schreiben kann mit dem Index-Impuls synchro- 
nisiert werden. 


IO Command 
IO Flags 


IO Length 
IO Data 


IO Offset 


IO_ Error 


TD_RAWWRITE 

Null, wenn die Daten ohne Index-Impuls-Synchronisierung ge- 
speichert werden soll. 

IOTF INDEXSYNC (Bit 4 = 1), wenn vor dem Schreiben auf den 
Index-Impuls gewartet werden soll (ab V36) 

Länge in Bytes, die gespeichert werden sollen (max. 32768 Bytes) 
Adresse des Datenpuffers, wo die zu speichernden Daten liegen (muß 
im CHIP-RAM liegen) 

Trackoffset => Tracknummer (0-159) x TrackSize (5632) ab dem der 
Track gespeichert wird 

Fehlernummer oder Null für alles OK 


Command: TD_GETDRIVETYPE (18) 


Daten über angeschlossenes Laufwerk holen (3,5 oder 5,25 etc.). 


IO Command 
IO Error 
IO Actual 


TD_GETDRIVETYPE 

Fehlernummer oder Null für alles OK 

wenn IO Error = Null, dann steht hier der Typ des Laufwerks 
DRIVE3 5 (Wert 1) für 3,5 Laufwerke 

DRIVE5 25 (Wert 2) für 5,25 Laufwerke 

DRIVE3_5_150RPM (Wert 3) 


Command: TD_GETNUMTRACKS (19) 


Maximale Anzahl Tracks des angeschlossenen Laufwerks ermitteln. 


IO Command 
IO Error 
IO Actual 


ih 


TD_GETNUMTRACKS 
Fehlernummer oder Null für alles OK 
wenn IO_Error = Null, dann steht hier die Anzahl Tracks (z. B. 160) 


Seite 316 


Das Trackdisk-Devi itel 


Command: TD ADDCHANGEINT (20) 


Einen eigenen Interrupt in die Systemliste einhängen, welcher immer 
aufgerufen wird, wenn eine Diskette entfernt oder eingelegt wird. 
Dieser Befehl funktioniert erst ab Kickstart 2.04 (V36) und muß mit 
der Funktion "SendIO ()" ausgeführt werden, weil sonst solange 
gewartet wird, bis das Ereignis eingetreten ist. 


IO Command = TD_ADDCHANGEINT 

IO Flags = Null 

IO Length = Länge der Interrupt-Struktur (8 Bytes) 

IO Data = Adresse einer initialisierten Exec-Interrupt-Struktur 

IO Error = Fehlernummer oder Null für alles OK 
Interrupt-Struktur: 


00  L 1IS_DATA Zeiger auf Datenpuffer für Programm (z. B. 4000 Bytes) 
04 L IS_CODE Adresse des eigenen Interruptprogrammes (muß mit Null in 
DO enden) 


mmand: TD REMCHANGEI 21 


Entfernt einen eigenen Interrupt, welcher mit dem Befehl "ADD- 
CHANGEINT" in das System eingebunden wurde. Funktioniert erst ab 
Kickstart 2.04 (V36). 


IO Command = TD_REMCHANGEINT 

IO_ Flags = Null 

IO_ Length = Länge der Interrupt-Struktur (8 Bytes) 
IO_Data = Adresse einer eigenen Interrupt-Struktur 
IO_Error = Fehlernummer oder Null für alles OK 
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Command: TD_GETGEOMETRY (21 


Informationen über angeschlossenes Laufwerk einholen. Dieses 
Kommando gibt es erst ab Kickstart 2.04 (V36). Dafür wird in 
IO_Data die Adresse einer DriveGeometry-Struktur übergeben und in 
IO_ Length die Länge dieser (32 Bytes). 


IO Command = TD_GETGEOMETRY 

IO Length = Länge der DriveGeometry-Struktur (32 Bytes) 
IO Data = Adresse der DriveGeometry-Struktur 

IO_Error = Fehlernummer oder Null für alles OK 


Aufbau _der DriveGeometry-Struktur (32 Bytes): 


Welche Werte in der Struktur initialisiert werden, hängt vom angeschlossenem Gerät 
ab. Es gibt drei Möglichkeiten des Aufbaus eines Gerätes: 


1. TotalSectors (meistens) 
2. Cylinders und CylSectors (nicht so oft) 
3. Cylinders, Heads und TrackSectors (selten) 


Offset: Typ: Name: Funktion: 

00 1  SectorSize Länge des Sektors in Bytes 

04 1  TotalSectors Anzahl der Sektoren des Gerätes 

08 L  XCylinders Anzahl der Cylinder 

12 1  CylSectors Anzahl Sektoren pro Cylinder 

16 L Heads Anzahl Köpfe die das Gerät besitzt 

20 1  TrackSectorsAnzahl Sektoren pro Track 

24  L  BufMemTyp Speicherart, die benötigt wird (siehe Exec-Funktion 
AllocMem () - meistens Public) 

28 DB DeviceType Art des Gerätes (siehe unten) 

29 B Flags Null oder "DG_Removeable* (Bit 0) für Gerät ist 
wechselbar (SyquestPlatte) 

30 \W Reserved Reserviert für spätere Erweiterungen 


32 Ende der Struktur 


Mögliche Werte für DeviceType: 


Wert Name 

00 DG DIRECT ACCESS Gerät mit direkter Zugriff 

01 DG_SEQUENTIAL_ ACCESS Gerät mit sequentieller Zugriff (seriell) 
02 DG PRINTER Gerät ist ein Drucker 

03 DG _PROCESSOR 

04 DG_WORM 
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05 DG CDROM 

06 DG SCANNER 

07 DG OPTICAL _DISK 

08 DG MEDIUM CHANGER 
09 DG COMMUNICATION 
31 DG UNKNOWN 


Gerät ist ein CD_ROM-Laufwerk 
Gerät ist ein Scanner 


unbekanntes Gerät (Device) 


Command: TD_EJECT (22) 


Speichermedium (Disk, Wechselplatte, CD etc) auswerfen oder ein- 
binden. Dieser Befehl wird nicht vom normalen "trackdisk.device" 
unterstützt, ist aber für spätere Erweiterungen bereits definiert (ab 
Kickstart 2.04 /V36). 


IO Command = TD_EJECT 

IO Length = Null für Medium einbinden (Abhängig vom Gerät) oder 
Eins für Medium auswerfen 

IO_Error = Fehlernummer oder Null für alles OK 


In IO Error bekommt man nach einem Befehl eine Null zurück (alles 
OK) oder eine Fehlemummer, die folgendes bedeutet: 


Nr: 
20 TDERR_NotSpecified 
21 TDERR NoSecHdr 


22 TDERR BadSecPreamble 


23 TDERR_BadSecID 

24 TDERR_BadHdrSum 
25 TDERR_BadSecSum 
26 TDERR_TooFewSecs 
27 TDERR BadSecHdr 
28 TDERR _WriteProt 

29 TDERR_DiskChanged 
30 TDERR_SeekError 

31 TDERR_NoMem 

32 TDERR_BadUnitNum 
33 TDERR_BadDriveType 
34 TDERR_DrivelnUse 


35 TDERR_PostReset 


Fehler läßt sich nicht genau lokalisieren 

Kein SectorHeader vorhanden 

ungültiger Sektorvorspann 

ungültige Sektor-ID 

ungültige Header-Checksumme 

ungültige Sector-Checksumme 

zu wenig Sektoren vorhanden 

ungültiger Sektorheader 

Diskette ist schreibgeschützt 

Diskette wurde gewechselt oder nicht im Laufwerk 
Fehler beim positionieren des Schreib-/Lesekopfes 
nicht genug Speicher für das Kommando X 
ungültige Sektornummer 

ungültiger Laufwerkstyp 

es wird gerade von einem anderem Task auf das 
Laufwerk zugegriffen 

Laufwerk in Resetphase 
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Außer den normalen Befehlen gibt es noch die erweiterten Befehle, 
die Abhängig sind von der Anzahl Diskettenwechsel. 


erweiterte Befehle des Trackdisk-Device: 


Befehl Wert ___ Funkti 

ETD_READ 8002 Die gleiche 

ETD_ WRITE 8003 Funktion, wie 

ETD UPDATE 8004 bei den "normalen" 
ETD_CLEAR 8005 Befehlen, nur das 
ETD_MOTOR $8009 diese in Abhängigkeit 
ETD_SEEK $800A der Diskettenwechsel 
ETD FORMAT $800B stehen 
ETD_RAWREAD 8010 

ETD RAWWRITE $8011 


Alle erweiterten Befehle arbeiten nur, wenn der interne Disketten- 
wechselzähler kleiner oder gleich dem von Ihnen eingestellten ist 
(siehe IOExtTD-Struktur - unten). 


Benutzt man einen erweiterten Befehl, so ist noch eine zusätzliche 
Struktur erforderlich, die direkt an die Basis-Struktur grenzen muß. 
Sie besteht aus zwei Einträgen. 


IOExtTD-Struktur (8 Bytes): 


Offset Typ N Funktion 

48 \W IOTD Count Anzahl der erlaubten Diskettenwechsel oder -1 für egal 

50 L IOTD SecLabel Adresse von einem 16-Byte großen Puffer. Hier wird der 
Sektorheader abgelegt (siehe Kapitel 2). 


Um ein Kommando über das Device zu starten, setzt man den 
entsprechenden Befehl in "IO_Command" (Offset 28) mit den 
dazugehörigen Parametern und ruft die Funktion "DOIO ()" oder 
"SendlO ()" auf. 


Bei der Funktion "DOIO ()" wartet das aufrufende Programm, bis die 
Funktion über das Device ausgeführt wird (OK-Message über 
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ReplyPort). Die zweite Variante ("SendiO ()") wartet nicht auf die 
Beendigung, sondern kehrt sofort zum aufrufenden Programm 
zurück. Zu beachten ist hierbei, daß nicht sofort ein neues 
Kommando ausgeführt werden kann. Ansonsten wird das vorherige 
Kommando evtl. unterbrochen. Um das zu verhindern kann man mit 
der Funktion "ChecklO ()" testen ob das Device-Kommando schon 
ausgeführt wurde (=>DO = Null, dann noch nicht fertig). Es gibt 
auch noch die Funktion "WaitlO ()" die auf die Beendigung wartet 
(SendiO + WaitlO = DOIO). Wie die Routinen genau funktionieren 
wird im Kapitel 13 beschrieben. 


Achtung! - Die DevicelO-Struktur muß an eine Adresse stehen, die 
durch 8 teilbar ist, sonst entstehen die merkwürdigsten Ergebnisse. 


5.2 Beispiele zum Trackdisk-Device 


Zum Abschluß des Kapitels folgt ein Beispiellisting, was das Trackdisk- 
Device öffnet und einige Unterroutinen für die Ansteuerung bein- 
haltet (Block laden, Motor ein- u. ausschalten) 


move.| 4,36 


sub.l al,al 

jsr -294(a6) ; FindTask () 

lea ReadReply,al 

move.l dO,$10(a1) ; ReplyPort eintragen 
move.|l 4,36 

jsr -354(a6) ; AddPort () 


--- TrackDisk-Device öffnen (DFO) --- 


lea DiskIO,a1 

move.| #ReadReply,14(a1) 

moveq ‚dO ‚ DFO 
moveq #0,d1 ; keine Flags 
lea trackdevice,a0 
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move.| 4,36 


jsr -444(36) ; OpenDevice () 
move.|  dO,trackdisk 
bne Ende 
;-— Block 880 und 881 lesen --- 
move.l #880,d0 ‚ ab Block 880 
move.|l #512*2,d1 ; 2 Blöcke 
bsr ReadDaten 
move.l dO,DatenAdresse 
beq Ende 
wait: 
btst #10,$dff016 ‚ rechte Maus ? 
bne wait 


aa belegten Speicher wieder zurückgeben ---- 


move.| #512*2,dO ; Länge = 2 Blöcke 
move.|l DatenAdresse,al 
bsr FreeDaten 


Ende: 

tst.w trackdisk 

bne Ende 1 

lea DiskIO,a 

move.l 4,36 

jsr -450(a6) ; CloseDevice () 
Ende 1 

lea ReadReply,al 

move.|l 4,36 

jsr -360(a6) ; RemPort () 

rts 


- Daten freigeben de 
- Al = DatenAdresse wie 
- DO = Länge in Bytes . 


.m—— || — m umm— mm mnn nn nn nn uenmn nn nn nun non nn nn nn nenn n nn. 


FreeDaten: 
move.| al,dı 
beq FreeDaten Ende 


divu #512,d0 
move.w dO,d2 
mulu #512,d2 
swap dO 
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tel 5 


Trackdisk-Device 


tst.w dO 

beq FreeDaten_2 

add.l #512,d2 
FreeDaten_2: 


move.|l d2,dO 

move.| 4,36 

jsr -210(a6) ; FreeAnim () 
FreeDaten Ende: 

rts 
;- Daten lesen a. 


= D1 = Länge in Bytes _ 
—- => DO = Adresse oder 0 -- 


._———...————. || mnbnmhnnnnhnnnnnuninnnnnnnennteneummnne 


—- DO = Blockstartnummer an 


ReadDaten: 
move.| dO,BlockStartNummer 
divu #512,d1 
move.w di,d2 
mulu #512,d2 
swap di 
tst.w d1 
beq ReadDaten_2 
acd.| #512,d2 
ReadDaten_2: 
move.l d2,BlockLaenge 
move.l| d2,dO 
move.|l #%10003,d1 
move.| 4,36 


jsr -198(a6) ; AllocMem () 
move.| dO,Daten_Adr 

beq ReadDaten_Error 

lea DiskIO,a1 

move.w #9,28(al) ; Command: Motor 
move.| #1,36(a1) ; Motor ein 

move.| 4,36 

Isr -456(a6) ; DoIO () 

lea DiskIO,al 

move.w #2,28(al) ; Command: READ 


move.l Daten Adr,40(al) ; Diskpuffer 
move.l BilockLaenge,36(a1) ; Länge 

move.|l BlockStartNummer,dI 

mulu #512,d1 

move.|l d1,44(a]) ; Offset in Blocks 


Seite 323 


Das Trackdisk-Device 


move.| 4,36 


jsr -456(a6) ; DoIO () 
lea DiskIO,al 
move.w #9,28(al) ; Command: Motor 
move.|l #0,36(al) ; Motor aus 
move.| 4,36 
jsr -456(36) ; DoIO () 
move.| Daten Adr,dO 
rts 
ReadDaten_Error: 
movegq #0,d0 
rts 
Daten Adr: dc.| O0 
BlockStartNummer: dc. O 
BlockLaenge: dc. 0 
TrackDevice: dc.b "trackdisk.device",O 
even 
trackdisk: dc.l 0 
cnop 0,8 ; Adresse durch 8 teilbar 


DiskIO: bik.b 48, 


0 ; ohne Erweiterung 
ReadReply: bik.b 34,0 


DatenAdresse: dc. 0 
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6. Das IDE/SCSI-Device 


Für die Diskettenlaufwerke stellt das Trackdisk-Device die Funktionen 
für den Datentransfer mit der Diskette bereit. Bei Festplatten über- 
nimmt das SCSI-Device diese Aufgaben. 


Die heutigen Festplatten werden in der Regel über die interne IDE- 
Schnittstelle oder einen SCSI-Controller betrieben. Die Kommunikation 
zwischen Schnittstelle und Gerät läuft über das SCSI-Device, das zum 
Lieferumfang der Workbench gehört (Install-Disk). 


Wie wir bereits aus Kapitel 5 wissen, handelt es sich bei den Devices 
um eingenständige Programme, die über Befehle bestimmte Opera- 
tionen selbständig ausführen. Der Ablauf entspricht genau dem vom 
Trackdisk-Device (Kapitel 5). Zur Erinnerung das Ganze nochmal in 
der Übersicht: 


1) FindTask (Al) 
Al = O (eingener Name) 
=>DO = eigene Taskadresse (Process-Struktur) 


2) eigene Taskadresse in RepiyPort (Offset 10) eintragen 


3) AddPort (A1) 
Al = ReplyPort-Adresse (Puffer von 32 Bytes) 


4) OpenDevice (A1,A0,D0,D1) 
AO = Zeiger auf Devicenamen ("scsi.device",O) 


Al = Zeiger auf DevicelO-Struktur (Puffer von 48 Bytes) 
DO = Flags (Null) 
D1 = Unit (siehe unten) 


=>DO = 0, dann konnte Device geöffnet werden, sonst Fehler 


5) ReplyPort in DevicelO-Struktur eintragen (Offset 10) 
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Um ein Device wieder freizugeben (bei Beendigung des Programms), 
muß der ReplyPort entfernt und das Device geschlossen werden. 


1) RemPort (Al) 
Al = Adresse des ReplyPort 


2) CloseDevice (A1) 
Al = Zeiger auf DevicelO-Struktur 


Die Unit-Nummer für OpenDevice (D1) ist für SCSI-Geräte etwas 
komplizierter aufgebaut. Aus Kapitel 1.2.9 wissen wir, daß bis zu acht 
Geräte an der SCSI-Schnittstelle betrieben werden können (1 Initiator 
und 7 Targets). Die Unit-Nummer wird als 3stellige dezimal codierte 
Zahl übergeben und hat folgenden Aufbau: 


Unit = XXX (321 => Stellennummern) 


1. Stelle = Busadresse vom Target (Ziel) =>0Obis7 
2. Stelle = logische Unit-Nummer (LUN) =>0Obi7 
3. Stelle = Nummer des Controller-Boards =>0Obis7 


Der Amiga 1200/600 hat nur eine interne IDE-Schnittstelle, die über 
das SCSI-Device kontrolliert wird. Alle Geräte die hierüber angesteuert 
werden, haben als Controller-Board-Nummer (3. Stelle) den Wert 
Null. Wird nur eine Festplatte am internen Port betrieben, ist die 
Busadresse und logische Unit (LUN) auch Null. 


Bei unbekannter Unit-Nummer, kann über die DOS-Funktion "Info ()" 
diese ermittelt werden oder man probiert alle möglichen Nummern 
durch. Das Workbenchutility. "HDToolBox" geht alle 64 Kombina- 
tionen der Unit-Nummern durch und erfährt so, ob und welche 
Geräte angeschlossen sind. 
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Folgende Unit-Kombinationen versucht HDToolBox über OpenDevice 
zu testen: 


00 01 02 03 04 05 06 07 
10 11 12 13 14 15 16 17 
20 21 22 23 24 25 26 27 
30 31 32 33 34 39 36 37 
40 41 42 43 44 45 46 47 
50 51 32 33 54 32 56 57 
60 61 62 63 64 65 66 67 
70 71 72 73 74 75 76 77 


Wie sich erkennen läßt, werden immer alle 8 LUNs jeder Busadresse 
getestet. Unser Beispiel am Ende des Kapitels verwendet als Unit den 
Wert Null. Sie sollten also darauf achten, daß Ihre Festplatte auch die 
Unit-Nummer Null besitzt, andernfalls sollten Sie die Nummer 
ändern. 


6.1 Der RigidDiskBlock (RDB) 


In den Amiga-Anfangszeiten, waren die Festplatten noch recht teuer 
und die Kapazität sehr gering. Um die maximale Geschwindigkeit 
auszureitzen, lieferte jede Firma ihren eigenen Treiber und Controller. 
Das führte dazu, daß die gleiche Festplatte unter einem anderen 
Controller nicht mehr erkannt wurde. Aus diesem Grund und den 
fallenden Festplattenpreisen, entwickelte Commodore einen 
einheitlichen Standard zur Kommunikation mit Festplatten - den 
Rigid-Disk-Block (RDB). 


Der RigidDiskBlock enthält alle wichtigen Informationen über die 
Festplatte und Stellt damit sozusagen den Rootblock für Festplatten 
da. Der RDB muß innerhalb der ersten 16 Blöcke einer Festplatte 
definiert sein (Normal = Blocknummer Null). Denn wir werden 
gleich noch feststellen, daß weitere Informationsblöcke (HardBlocks) 
am Anfang der Platte untergebracht sind. Aus diesem Grund sind 
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meistens die ersten beiden Cylinder einer Platte reserviert und somit 
"nicht" vom Amiga-DOS nutzbar. 


Aufbau der RigidDiskBlock-Struktur (256 Bytes) 


Offset Name 

000 rdb_ID 

004 rdb_Summedlongs 
008 rdb_ChkSum 

012 rdb_HostlD 

016 rdb_BlockBytes 

020 rdb Flags 

024 rdb BadBlocklList 

028 rdb_PartitionList 

032  rdb_FileSysHeaderlist 
036 rdb_Drivelnit 

040 rdb_Reserved1,6x4 
064 rdb_Cylinders 

068 rdb Sectors 

072 rdb Heads 

076 rdb_Interleave 

080 rdb Park 

084 rdb _Reserved2,3x4 
096 rdb_WritePreComp 
100 rdb Reduced\Wfrite 
104  rdb StepRate 

108 rdb _Reserved3,5x4 
128 rdb_RDBBlocklo 

132  rdb_RDBBlockHi 

136 rdb_LoCylinder 

140  rdb HiCylinder 

144  rdb _CylBlocks 

148 rdb_AutoParkSeconds 
152  rdb _HighRDSKBlock 
156 rdb Reserved4,1x4 
160  rdb_DiskVendor,8 
168 rdb_DiskProduct, 16 
184  rdb_DiskRevision,4 
188 rdb_ControllerVendor,8 
196  rdb ControllerProduct, 16 
212  rdb ControllerRevision,4 
216 rdb Reserved5,10x4 
256 Ende 


Eine Block-Null-Adresse kann auch durch den Wert SFFFFFFFF definiert sein. 


Funktion 

ASCII-Kennzeichnung ("RDSK*) 

Länge des Blocks in Longwords 

Checksumme vom Block 

Nummer vom SCSI-Host-Target (Normal = 7) 
Byteanzahl pro Block (Normal = 512) 

Flags => siehe unten 

Blocknummer der BadBlockBlock-Struktur o. Null 
Blocknr. der ersten PartitionBlock-Struktur o. Null 
Blocknr. der FileSysHeaderBlock-Struktur o. Null 
Initialisierungscode für das Gerät oder Null 
Drivelnit (lun,rdb,ior) (DO,AO,A1) 

reserviert (6 Longwords a $FFFFFFFF) 

Anzahl Cylinder der Platte 

Anzahl Sektoren pro Track 

Anzahl Köpfe der Platte 

Interleave-Faktor der Platte 

Cylindernummer für das Parken der Köpfe 
reserviert (3 Longwords a $FFFFFFFF) 
Cylinderstart für Write-Precompensation 
Cylinderstart für Reduced-Write-Current 

Steprate der Platte 

reserviert (5 Longwords a $FFFFFFFF) 

erste Blocknr. für reservierten HardBlock-Bereich 
letzte Blocknr. für reservierten HardBlock-Bereich 
erster Cylinder des Partitionsbereich (Normal = 2) 
letzter Cylinder des Partitionsbereich 

Anzahl Blöcke pro Cylinder (z. B. 1008) 
Zeitspanne fürs Parken o. Null für kein AutoPark 
letzte Blocknr. d. HardBlock-Bereichs ohne BadBlock 
reserviert (1 Longword a $FFFFFFFF) 

8 Bytes mit Plattennamen (z.B. Maxtor) 

16 Bytes mit Produktbezeichnung (z.B. 71260AT) 
4 Bytes mit Versionsnummer (z.B. MA8X) 

8 Bytes mit Controllernamen 

16 Bytes mit Controller-Produkt-Bezeichnung 

4 Bytes mit Controller-Versionsnummer 

reserviert (10 Longwords a $FFFFFFFF) 
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Mögli Bits für RDB-Fla t2 
RDBF LAST letztes zu konfigurierendes Gerät für diesen Controller 
RDBF_LASTLUN letzte zu konfigurierende LUN ab dieser SCSI-Target-ID 
RDBF LASTID letzte zu konfigurierende Target-ID auf dieser SCSI-Busadresse 
RDBF NORESELECT Bei Verbindung, Gerät nicht reselektieren 
RDBF_DISKID Identifikation für RDB-Platte 
RDBF_CTRLRID Identifikation für RDB-Controller 
RDBF SYNCH SCSI-Synchronisationsmodus einschalten (Vorsicht) 


Der PartitionList-Eintrag (Offset 28) vom RDB enthält die Block- 
nummer der ersten PartitionBlock-Struktur, welche alle wichtigen 
Informationen einer Partition enthält. 


036 
068 
128 
196 
256 


0 
1 


Aufbau der PartitionBlock-Struktur (256 Bytes) 


Funkti 
pb_ID ASCII-Kennzeichnung ("PART") 
pb_Summedlongs Länge des Blocks in Longwords 
pb_ChkSum Checksumme vom Block 
pb_HostlD Nummer vom SCSI-Host-Target (Normal = 7) 
pb_Next Nummer des nächsten PartitionBlocks o. Null 
pb_Flags Flags = > siehe unten 
pb_Reserved1,2x4 reserviert (2 Longwords a $FFFFFFFF) 
pb_DevFlags Flagwert für OpenDevice (DO) 
pb_DriveName,32 32 Bytes mit Devicenamen, BCPL (4,"DHO:") 
pb Reserved2,15x4 reserviert (15 Longwords a $FFFFFFFF) 
pb_Environment,17x4 Environment-Vektor für diese Partition (68 Bytes) 
pb_EReserved, 15x4 reserviert für Environment-Vektor der Zukunft 
Ende 

Mögliche Bits für Partition-Fl t2 
Funkt; 
PBF_Bootable bootbare Partition 
PBF_NoMount Partition darf nicht gemounted werden 
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Der FileSysHeaderList-Eintrag (Offset 32) vom RDB enthält die 
Blocknummer der 
wichtigen Informationen über das verwendete Filesystem enthält. 


FilesysHeaderBlock-Struktur, die alle 


Aufbau der FileSysHeaderBlock-Struktur (256 Bytes) 


Offset Name 


000 
004 
008 
012 
016 
020 
024 
032 
036 
040 
044 
048 
052 
056 
060 
064 
072 
076 
080 
172 
256 


fhb_ID 

fhb SummedLongs 
fhb_ChkSsum 
fhb_HostID 
fhb_Next 
fhb_Flags 
fhb_Reserved1,2x4 
fhb_DosType 
fhb_Version 
fhb_PatchFlags 

fhb Type 

fhb_Task 

fhb_Lock 
fhb_Handler 
fhb_StackSize 
fhb_Priority 
fhb_SegListBlocks 
fhb_GlobalVec 
fhb_Reserved2,23x4 
fhb_Reserved3,21x4 
Ende 


Funkti 

ASCII-Kennzeichnung ("FSHD*) 

Länge des Blocks in Longwords 
Checksumme vom Block 

Nummer vom SCSI-Host-Target (Normal = 7) 
Nummer des nächsten FSHD-Block o. Null 
Flags = > siehe unten 

reserviert (2 Longwords a $FFFFFFFF) 
Dos-Type (siehe Kapitel 7) 
Versionsnummer des Programmcode 
Flags für das Filesystem 

DeviceNode-Type (Null) 
Standard-DOS-Task-Eintrag (Null) 
unbenutzt für Device (Null) 

Filename für LoadS$eg () 

Stackgröße für Handler-Task 

Taskpriorität 

Nummer der ersten LoadSegBlock-Struktur 
Global-Vektor 

reserviert (23 Longwords a $FFFFFFFF) 
reserviert (21 Longwords a $FFFFFFFF) 


Der FSHD-Block enthält eine fast vollständige DosList-Struktur. Nähere 
Informationen können Sie dem Kapitel 7 entnehmen. 


Der SegListBlock-Eintrag (Offset 72) vom FSHD-Block zeigt auf die 
Blocknummer der ersten LoadSegBlock-Struktur, welche die Pro- 
grammdaten für den FileHandler beinhaltet. 
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004 
012 
016 
020 


256 


Der 


ID I-Devi itel 
r Block- r (256 
Funkti 
Isb_ID ASCII-Kennzeichnung ("LSEG") 
Isb_ Summedlongs Länge des Blocks in Longwords 
Isb_ChkSum Checksumme vom Block 
Isb_HostID Nummer vom SCSI-Host-Target (Normal = 7) 
Isb_Next Nummer des nächsten LoadSeg-Block o. Null 
Isb LoadData,123*4 max. 123 Longwords, welche jeweils die Blocknr. 


der Daten des Filehandlers enthalten 
Ende 


BadBlockList-Eintrag (Offset 24) vom RDB enthält die 


Blocknummer einer BadBlockBlock-Struktur, welche die Nummern der 
defekten Blöcke enthält. 


004 
008 
012 
016 
020 
024 


512 


000 
004 
008 


Aufbau _der BadBlockBlock-Struktur (512 Bytes) 


Funkti 
bbb_ID ASCII-Kennzeichnung ("BADB") 
bbb_SummedLongs Länge des Blocks in Longwords 

bbb_ChkSum Checksumme vom Block 

bbb_HostID Nummer vom SCSI-Host-Target (Normal = 7) 
bbb_Next Nummer des nächsten BADB-Block o. Null 
bbb_ Reserved reserviert (1 Longword) 


bbb BlockPairs,61xBadBlockEntty max. 61 BadBlockEntry-Einträge a zwei 
Longwords (8 Bytes) 


Ende 
u einer BadBlockEn 
bbe_BadBlock Blocknummer des defekten Blocks 
bbe _GoodBlock Blocknummer des Ersatzblocks für BadBlock 
Ende 
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6.2 Funktionen des SCSI-Device 


Die Grundfunktionen laufen nach dem gleichen Prinzip ab, wie beim 
TrackDisk-Device. Dafür wird auch eine BasisIO-Struktur benötigt. Den 
Aufbau können Sie dem Kapitel 5 entnehmen. Allerdings steht einem 
nicht der gesamte Befehlssatz zur Auswahl. 


Grundbefehle für das SCSI-Device 


Befehl Wert _ __ Funktion 

CMD Read 2 einen oder mehrere Blöcke einlesen 
CMD Write 3 einen oder mehrere Blöcke schreiben 
CMD_ Stop 6 letzten SCSI-Befehl anhalten 

CMD Start 7 letzten SCSI-Befehl wieder fortsetzen 
TD_Seek 10 Schreib-/Lesekopf bewegen (Offset in Tracks) 
TD_Format 11 einen oder mehrere Tracks formatieren 
TD _ChangeState 14 Testen ob ein Medium vorhanden ist 
TD_ProStatus 15 Schreibschutz testen (von CD, HD, etc.) 
TD_GetGeometry 22 Informationen über das Gerät einlesen 
TD_Eject 23 neues Medium einbinden 


Der Ablauf und die notwendigen Parameter werden im Kapitel 5.1 
beschrieben. Achtung - Beachten Sie, daß sich die Blocknummern des 
Amiga-DOS nicht auf den Anfang einer Festplatte beziehen (Cylinder 
Null), sondern auf den ersten Cylinder nach den HardBlocks 
(rdb_LoCylinder). Die tatsächliche Blocknummer für den AmigaDOS- 
Zugriff errechnet sich dann wie folgt: 


rdb_LoCylinder (in Blocks) + AmigaDOSBlock 


Das SCSI-Device bietet noch die Möglichkeit direkte CCS-Kommandos 
(s. Kapitel 1.2.9) an das SCSI-Gerät zu senden. Mit dem Befehl 
HD_SCSICMD (28) und einer SCSICmd-Struktur werden die CCS- 
Befehle übermittelt. Dazu muß die Adresse der SCSICmd-Struktur in 
IO_Data, die Länge der Struktur (30 Bytes) in IO Length und das 
HD_SCSICMD-Kommando (28) in IO_Command der DevicelO-Struktur 
eingetragen werden. 
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00 scsi_Data 


04  scsi Length 
08 scsi_Actual 


12 _ scsi Command 


16 scsi_CmdLength 
18  scsi CmdActual 


20  scsi_Flags 
21  scsi_Status 


22 _ scsi_ SenseData 


26 scsi _SenseLength 
28  scsi_SenseActual 


Funkti 
Datenpufferadresse (256 Bytes) für die SCSI-Datenphase. 

Hier werden Daten hineingeschrieben oder ausgelesen. 

Größe des Datenpuffers für scsi_Data in Bytes 

tatsächliche Anzahl Daten, die transferiert wurden (zu Be- 
ginn auf Null setzen) 

Adresse auf CCS-Befehlszeile (Kapitel 1.2.9). In der Regel 6 
Bytes. Genaue Informationen => SCSI-Literatur 

Länge der CCS-Befehlszeile in Bytes (Normal 6) 

tatsächliche Anzahl Bytes der CCS-Befehle, die übertragen 
wurden (zu Beginn auf Null setzen) 

Flags - siehe unten 

Status nach dem CCS-Befehl (Informationen in SCSI-Spezifika- 
tionen - z. B. Check_Condition = 2) 

wenn das SCSI AutoSense-Bit in Flags gesetzt ist, muß dieser 
Zeiger auf eine Pufferadresse von max. 256 Bytes zeigen. 
Hier werden für CCS-Sense-Operationen die Daten abgelegt. 
Größe des Datenpuffers für scsi SenseData in Bytes 
tatsächliche Anzahl Sensedaten, die transferiert wurden (zu Be- 
ginn auf Null setzen - Wichtig) 


30 Ende 
Flags für die SCSICmd-Struktur 20 
Funkt; 
SCSIF WRITE 0 Datenrichtung ist Ausgeben 
SCSIF READ 1 Datenrichtung ist Einlesen 


SCSIF NOSENSE 
SCSIF AUTOSENSE 
SCSIF OLDAUTOSENSE 


SCSIB_READ WRITE 
SCSIB AUTOSENSE 
SCSIB_OLDAUTOSENSE 


0 keine automatische Sensedaten-Bearbeitung 
2 automatische Sensedaten-Bearbeitung 

6 4-Byte Sensedaten-Bearbeitung (nicht mehr) 
0 
1 
2 


Bit-Test-Wert (unwichtig) 
Bit-Test-Wert (unwichtig) 
Bit-Test-Wert (unwichtig) 


Genauere Informationen über die CCS-Befehle finden Sie in den SCSI- 
Spezifikationen oder entsprechender Literatur. Das Beispiel im nächs- 
ten Abschnitt, führt das CCS-Kommando ReadCapacity ($25) aus und 
bekommt als Ergebnis die Plattenkapazität in Blocks. 
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6.3 Beispielprogramm 


;--- SCSI-Demo: ließt die Kapazität in Blocks — 
;--- über SCSI-Direkt und über CMD Read den u 
;--- Block Null. Die Kapazität wird in DO und ... 
;--- die Blocknulladresse in DI zurückgegeben -- 
;--- Achtung, die Daten können etwas zerstört _— 
;--- sein (Blockadresse), weil der Speicher --- 
;--- am Ende des Programmes schon freigegeben -.. 
;j=--- wurde -_ 


move.|l 4,36 


sub.! al,al 

jsr -294(a6) ; FindTask () 

lea ReadReply,al 

move.l dO,$10(al) ; ReplyPort eintragen 
move.| 4,36 

jsr -354(a6) ; AddPort () 


ir SCSIDevice öffnen --- 


* 
' 


lea DiskIO,al 

move.l #ReadReply,14(a1) 

moveq #0,d0 ; Adress = 0, LUN = O 
moveg #0,d1 ; keine Flags 

lea scsidevice,a0 

move.| 4,36 

jsr -444 (a6) ; OpenDevice () 

move.l dO,scsidisk 

bne Ende 

bsr SCSI CMD ; SCSI-Direct-Command 


move.l dO,SCSIData 


;-— Block O lesen (evtl. der Rigid-Disk-Block) --- 


move.| #0,d0 ; Block O laden (evtl. RDB) 
move.| #512,d1 ; 1 Block 
bsr ReadDaten 
move.|l dO,DatenAdresse 
beq Ende 
;--- belegten Speicher wieder zurückgeben ---- 
move.| #512,d0 ‚ Länge = 1 Blöcke 
move.l DatenAdresse,al 
bsr FreeDaten 
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;--- Programm beenden --- 
Ende: 

tst.| scsidisk 

bne Ende _1 

lea DiskIO,a1 

move.|l 4,36 

jsr -450(a6) ; CloseDevice () 
Ende _1: 

lea ReadReply,al 

move.| 4,36 

jsr -360(a6) ; RemPort () 

move.l SCSIData,a0 ; SCSI_Data-Adresse 

move.l (a0),dO ; DO = Kapazität in Blocks 

move.l DatenAdrese,di ; Di = Adresse von Blocknummer Null 

rts -, 
in Daten freigeben --- 
j--- Al = DatenAdresse --- 
ij DO = Länge in Bytes ._ 
FreeDaten: 

move.|l al,dı 

beq FreeDaten_Ende 

divu.w #512,d0 

move.w dO,d2 

mulu.w #512,d2 

swap do 

tst.w do 

beq FreeDaten_2 

add.! #512,d2 
FreeDaten_2: 

move.l| d2,dO 

move.l 4,36 

jsr -210(a6) ; FreeMem () 
FreeDaten_Ende: 

rts 


Daten lesen --- 
DO = Blockstartnummer --- 
D1 = Länge in Bytes .. 
=> DO = Adresse oder 0 --- 
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ReadDaten: 
move.l dO,BlockStartNummer 
divu.w  #512,d1 
move.w di,d2 
mulu.w #512,d2 


swap di 
tst.w di 
beq ReadDaten_2 


add. #512,d2 
ReadDaten _2: 

move.| d2,BlockLaenge 

move.| 

move.l #%10003,d1 

move.l 4,36 


jsr -198(a6) ; AllocMem () 

move.l dO,Daten_Adr 

beq ReadDaten_Error 

lea DisklO,al 

move.w #2,28(al) ; Command: READ 

move.l Daten Adr,40(a1) ; Diskpuffer 

move.|l BlockLaenge,36(a1) ; Länge 

move.|l BlockStartNummer,dI 

Isl.l #8,d1 

Ist. #1,d1 ; Nummer mal 512 
; add. #1008*2*512,d1 ; evtl. für DOS-Blockstart, wenn 


; rdb_LoCylinder = 2 und 
;rdb CylBlocks = 1008 und 
; rdb_BlockBytes = 512 


We ee a A 


move.| d1,44(al) ; Offset in Blocks 
move.| 4,36 
jsr -456(a6) ; DoIO () 
move.|l Daten Adr,dO 
rts 
ReadDaten_Error: 
moveq #0,d0 
rts 
Daten Adr: dc.! O 
BlockStartNummer: dc.! O 
BlockLaenge: dc.! O 


‘ 
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ReadCapacity: Kapazität in Blocks 
SCSI_Data-Adresse ooder 0 


’ 


move.w 
move.| 
jsr 
move.l 
rts 


cnop 0,8 


p 
SCSICmd: 


=> DO = 


SCSICmd,a0 
DisklO,al 
#28,28(a1) 
a0,40(a1) 
#30,36(a1) 


#RDB,0(a0) 
#254,4(a0) 
#command, 12(a0) 
#6,16(a0) 
#3,20(a0) 
#SenseData,22(a0) 
#18,26(a0) 
#0,28(a0) 


4,a6 
-456(a6) 
#RDB,dO 


bik.b 30,0 


._.————————— | | | —,n= 


bik.b 256,0 


cnop 0,8 
SenseData: bik.b 20,0 


SCSIData: 
DatenAdresse: dc.| O 


SCSIDevice: dc.b "scsi.device",O 
even 


scsidisk: 


cnop 0,8 


DiskIO: 
ReadReply: 


dc.I O0 


dc.! O 


bik.b 48,0 


bik.| 8,0 


; HD_SCSICMD 
; IO_ Data = > SCSICmd 
; IO Length => SCSICmd_Size 


‚ scsi Data => 256 Bytes-Puffer 
‚scsi Length => 254 Bytes 


‚ scsi Command = > 6-Byte-Befehl 


‚ scsi CmdLlength => 6 Bytes 


; scsi Flags => Read + AutoSense 
‚ scsi SenseData => 20 Bytes-Puffer 


‚ scsi Senselength => 18 Bytes 
‚ scsi SenseActual => 0 Bytes 


; DoIO () 


; SCSI-Befehl: ReadCapacity ($25) 


‚ Adresse durch 8 teilbar 
; ohne Erweiterung 
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7. Das Amiga-DOS 


Das Disk-Operating-System, kurz DOS, ist für alle Ein- und Ausgaben 
zuständig, die sich hauptsächlich auf das Filesystem und den Bild- 
schirm beziehen. Der Umfang der DOS-Funktionen hat bis zum 053.1 
stark zugenommen und wurde auch erheblich überarbeitet. 


7.1 Die Dos-Library 


Alle Funktionen des Amiga-DOS sind über die DOS-Library erreichbar. 
Sie ist Bestandteil des Kickstart-ROM. Möchte man auf eine Funktion 
zugreifen, so muß erst die DOS-Library geöffnet werden. 


Die Exec-Funktion "OpenLibrary ()" öffnet eine beliebige Library. Als 
Parameter müssen in Al die Adresse des Library-Namen und in DO 
die Versionsnummer stehen. Der Name muß mit einem Null-Byte 
enden. Als Versionsnummer kann man auch eine Null für die aktuelle 
Library im ROM übergeben. Konnte die Library geöffnet werden, 
wird in DO die Basisadresse dieser zurückgegeben, über die man die 
einzelnen Funktionen aufrufen kann. Ein Fehler wird durch eine Null 
in DO mitgeteilt. 


7.2 Die DOS-Routinen 


Wir werden hier nicht ausführlich auf alle Funktionen des DOS 
eingehen. Nur die "wichtigsten" werden wir genauer abhandeln. In 
der Regel reicht das aus, um die restlichen Funktionen auch benutzen 
zu können. 
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Wie schon De muß als erstes die DOS- Library geöffnet werden. 
Wenn das Öffnen erfolgreich ist, erhalten wir in DO die Basisadresse 
des Amiga-DOS zurück, die folgenden Aufbau hat: 


S-Library-Struktur 


Funkt; 
00  dilib Library-Struktur (siehe Kapitel 13 - Offset 10 = LibName) 
34 di Root Zeiger auf RootNode-Struktur (siehe unten) 

38 dIiGV Zeiger auf Global-Vektor 

42 dIA2 Adreßregister für interne Zwischenspeicherung von A2 

46 diA5 Adreßregister für interne Zwischenspeicherung von A5 

50 di A6 Adreßregister für interne Zwischenspeicherung von A6 

54 dl Errors Zeiger auf eine Tabelle mit Error-Meldungen 


58 di TimeReq Zeiger auf Timer-Request 
62 di UtilityBase Zeiger auf utility.library 
66 di IntuitionBase Zeiger auf intuition.library 
70 Ende 


Der einzige wichtige Eintrag ist di Root. Dieser zeigt auf eine 
RootNode-Struktur, über die man auf alle wichtigen Daten des DOS 
zugreifen kann. Die Einträge ab Offset 54 sind private Zeiger des 
Systems ab Version V36. 


Au r RootN r 


Funkti 

00  *rn TaskArray Zeiger auf eine Tabelle mit allen Shell-Processen (erste Eintrag 
enthält die Anzahl, dann folgen die Adressen) 

04 _*rn ConsoleSegment Zeiger auf Segmentenliste des Shell 


08 rn TIME ab hier liegt eine DateStamp-Struktur (12 Bytes) 
20 rn Restartfeg Zeiger auf Segmentliste des Disk-Validators 

24  *rn_Info Zeiger auf Dosinfo-Struktur (siehe unten) 

28 *rn FileHandlersegment Zeiger auf Segmentliste des Filehandlers 
32 rn Clilist ab hier liegt die CliList-Struktur (12 Bytes) 

44 rn BootProc Zeiger auf MessagePort für Boot-Prozess 

48  *rn ShellSegmentZeiger auf Segmentliste für Shell (NewShell) 

52 rn _Flags DOS-Flags 

56 Ende 


Die Einträge ab Offset 32 existieren erst ab der DOS-Version V36. 
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Alle Einträge die mit einem "*" gekenntzeichnet sino|, liegen als B- 
Pointer (BPIR) vor. Um die absolute Adresse zu erhalten, muß dieser 
B-Pointer mit vier multipliziert werden. Das DOS arbeitet vie/ mit 
solchen Pointern (Adressen). Zurückzuführen ist das auf die Program- 
miersprache. Das Amigae-DOS wurde anfangs in BCPL geschrieben, 
dem Vorgänger von *C". 


Beispiel für rn_Info-Eintrag: 


move.| dosbase,a6 


move.| 34(a6),a0 ; AD = Adresse der RootNode-Struktur 
move.| 24(a0),dO ; BPTR von rn_Info (*) 

asl.| #2,d0 ; BPTRx 4 

move.| dO,al ; Al = Adresse der DosInfo-Struktur 


Auch in der RootNode-Struktur ist nur der Eintrag rn_Info von Be- 
deutung. Er zeigt auf eine DosInfo-Struktur über die wir die ange- 
schlossenen Geräte ermitteln können. 


Aufbau der Dosinfo-Struktur (158 Bytes) 


N Funktion 
00 *di McName Zeiger auf Name für Netzwerk (Residente Liste) 
04  *di Devinfo Zeiger auf Device-Liste (siehe Unten) 
08 *di Devices unbenutzt (Null) 


12  *di Handlers unbenutzt (Null) 

16 di NetHand Zeiger auf Netzwerk-Handler (Null) 

20 di Devlock ab hier liegt eine DevLock-Struktur (46 Bytes - ab V36) 
66 di Entrylock ab hier liegt eine EntryLock-Struktur (46 Bytes - ab V36) 
112 di_Deletelock ab hier liegt eine DeleteLock-Struktur (46 Bytes - ab V36) 
158 Ende 


Die Einträge ab Offset 20 existieren erst ab der DOS-Version V36 und 
Einträge mit einem "*" sind wieder BPTR. Der di_Devinfo-Eintrag 
(BPTR) zeigt auf eine Devinfo- bzw. DeviceNode- oder eine DevList- 
Struktur. Wir benutzen für die Devinfo- und DeviceNode-Struktur die 
Bezeichnung DosList-Struktur. Alle besitzen eine Länge von 44 Bytes, 
die ersten 12 Bytes sind bei allen gleich. Der restliche Aufbau wird 
durch den Type-Eintrag (Offset 4) definiert. 
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01 
02 


04 


Ami 


Werte für Type-Eintrag (Offset 4) 


DLT_DEVICE 


DosList-Struktur für ein Device (z. Beispiel: "DFO:*) 


DLT DIRECTORY DevList-Struktur für ein Direktory-Assign ("CarRace*) 


DLT_ VOLUME 
DLT LATE 


DevList-Struktur für ein Volume (z.Beispiel: "Workbench*) 
wie DLT_DIRECTORY 


DLT_NONBINDING für noch nicht eingebundene Assigns 


DLT PRIVATE 


für intere Verarbeitung des DOS 


Als erstes beschreiben wir die DosList-Struktur. Sie hat den gleichen 
Aufbau wie die Devinfo- und DeviceNode-Struktur, 


04 
08 


12 
16 
20 
28 


32 


36 
40 
44 


Au 


*dol Next 
dol Type 

dol Task 

*dol Lock 
*dol Handler 
dol_StackSize 
dol_Priority 
dol_ Startup 


*dol_SegList 


*dol GlobVec 


*dol_ Name 


. Ende 


Tr ist-Struktur (44 B 


Funkti 
Zeiger auf nächste DosList- oder DevList-Struktur 

Type der Device-Liste (O=Device; siehe oben) 

Zeiger auf Handler-Task oder Null, wenn noch nicht auf 
dieses Device zugegriffen wurde 

Zeiger auf FileLock-Struktur (für ein Device = Null) 

Zeiger auf Handler-Filename, wenn dol SegList = Null 
Stackgröße für Handler-Task 

Priorität für Handler-Task 

Startup-Message-Zeiger für diesen Type (FileSysStartupMsg für 
Disketten) 

Segmentliste für Handler-Task (Wenn Null, dann wird der 
Handler auf den dol_Handler zeigt nachgeladen und die 
Segmentliste hier eingetragen) 

Global-Vektor-Adresse für Handlerstart (0 = Vektor erzeugen, 
-] = dol SegList benutzen) 

Zeiger auf DeviceName im BCPL-Format (das erste Byte ent- 
hält die Anzahl Zeichen vom Namen, danach folgt der Name) 


Seite 341 


Kapitel 7 


Aufbau der DevList-Struktur (44 Bytes) 


Funktion 
Zeiger auf nächste DosList- oder DevList-Struktur 
Type der Device-Liste (1=Direktory, 2=Volume; siehe oben) 


Zeiger auf Handler-Task oder Null, wenn noch nicht auf 
dieses Device zugegriffen wurde 


Das Amiga-DOS 
Offset Name 

00  *dl Next 

04 dl Type 

08 di Task 

12  *dl Lock 


16 di VolumeDate 
28  *dl_Locklist 


32 dl DiskType 


36 di unused 
40 *dl Name 
44 Ende 


Wert 

SFFFFFFFF 
542414400 
$S4E444F53 
$444F5300 
$444F5301 
$444F5302 
$444F5303 
$444F5304 
$444F5305 
$54B49434B 
$4D534400 


Zeiger auf FileLock-Struktur (für ein Device = Null) 
ab hier liegt eine DateStamp-Struktur (s. nächsten Abschnitt) 
Zeiger auf Liste aller FileLock-Strukturen für die Programme, 


welche alle im ACCESS READ-Modus hierauf zugreifen. 


Diskettenformat für diese Liste (siehe unten) 
unbenutzt 
Zeiger auf Namen im BCPL-Format (das erste Byte enthält 


die Anzahl Zeichen vom Namen, danach folgt der Name) 


ASCII-Format 
-1 
"BAD",O 
"NDOS" 
"DOS",O 
"DOS",1 
"DOS",2 
"BOS”,.3 
"DOS",4 
"DOS",5 
"KICK" 
"MSD",O 


Werte für DiskType-Eintrag (Offset 32) 


Funktion 

Keine Diskette im Laufwerk 

Diskette im DOS-Format, aber nicht lesbar 
Diskette nicht im DOS-Format 

Disk im OFS-Format (OldFileSystem) 

Disk im FFS-Format (FastFileSystem) 

Disk im OFS-Format und International-Modus 
Disk im FFS-Format und International-Modus 
Disk im OFS-Format + International + DirCache 
Disk im FFS-Format + International + DirCache 
Kickstart-Diskette (für A1000) 

Disk im MS-DOS-Format 


Das waren jetzt die wichtigsten Basis-Strukturen der "dos.library". 
Über die können wir alle angeschlossenen (Mounted) Geräte und 
Assigns ermitteln. Als erstes sollte immer der Task-Eintrag (Offset 8) 
getestet werden. Ist dieser Null, so wurde noch nicht auf das Gerät 
zugegriffen oder es handelt sich um einen Kanal wie SER, PAR, CON, 
RAW usw.. Andernfalls können wir die Adresse des Namen berechnen 
und danach ausgeben. Möchte man mehr Informationen über den 
Type ermitteln, berechnen wir einfach die Adresse des FileLocks 
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(Offset 12), übergeben diesen in DI der Dos-Funktion "Info ()" und 
in D2 die Adresse eines 36-Byte großen Puffers. Die Funktion wird 
ausführlich im nächsten Abschnitt beschrieben. 


Seit Kickstart 2.05 (V36) gibt es eine noch etwas elegantere Methode 
die Geräte und Assigns zu ermitteln. Über die Funktionen LockDostist 
(), NextDosEntry () und UnLockDostist (). 


Routine: LockDostist (Flags) (D1) 


Offset: -654 (ab V36) 

Paramter: D1 = Flags, die bestimmen welche Types gelocked werden sollen 
(Device, Direktory, Volumes, etc.) 

Rückgabe: =>DO = Adresse einer DosList-Struktur oder Null für Fehler 

Erklärung: 


Diese Funktion erzeugt einen Lock auf die genannten Typen (Device, Volume etc.) und 
gibt in DO die erste DostList-Struktur zurück. Die Werte in dieser Struktur dürfen wir 
noch nicht abfragen. Als erstes müssen wir zuvor die Funktion NextDosEntry () aufrufen 
und erhalten den ersten brauchbaren Typ-Eintrag. 


Routine: NextDosEntry (DosList,Flags) (D1,D2) 
6) 


Offset: -690 (ab V3 
Paramter: D1 = Adresse einer DosList-Struktur 
D2 = Flags, die bestimmen welche Types gelocked werden sollen 
(müssen die gleichen, wie bei LockDostist sein) 
Rückgabe: =>DO = Adresse der nächsten DosList-Struktur oder Null für Ende 
Erklärung: 


NextDosEntry sucht den nächsten passenden Type-Eintrag und gibt die DosList-Struktur 
von diesen Typ zurück. Ist keiner mehr vorhanden ist das Ergebnis Null. Als erste 
DosList-Struktur übergibt man das Ergebnis der Funktion LockDosList (), danach das 
Ergebnis von NextDosEntry () bis man eine Null erhält. Alle Strukturen die man erhält, 
können jetzt ausgewertet werden. 


Routine: UnLockDostList (Flags) (D1) 

Offset: -660 (ab V36) 

Paramter: D1 = Flags, die bestimmen welche Types unlocked werden sollen 
(müssen die gleichen sein, wie bei LockDosList) 

Rückgabe: keine 

Erklärung: 

Diese Funktion gibt den Lock auf alle Typen in Flags wieder frei. 


Seite 343 


Das Amiga-D itel 7 
Mögliche Bits für Flag 

Bit_ Name Funktion 

0 LDF _READ Alle Geräte u. Assigns die gelesen werden können 

1 LDF_WRITE Alle Geräte u. Assigns die beschrieben werden können 

2 LDF _DEVICES Nach Device-Einträge suchen (z.B.: "DFO") 

3 LDF VOLUMES Nach Volume-Einträgen suchen (z.B.: "Workbench") 

4 LDF ASSIGNS Nach Assign-Einträgen suchen (z.B.: "JumpNRun*) 

5 LDF ENTRY für interne Verarbeitung des DOS 

6 LDF DELETE keine Informationen 


Das Bit O oder 1 (Read/Write) muß immer mit mindestens einem 
anderen Bit gesetzt sein. 


Zur Demonstration ein Beispiellisting, das über die drei Funktionen 
alle Geräte und Assigns ermittelt und auf den Bildschirm ausgibt. 
Beachten Sie, daß das Programm erst ab der Dos-Version V36 
funktioniert. 


ee u .:———— |... 


ee en m nn u. _.—— 


Flag = 1+4+8+16 


lea 
moveq 
move.| 
jsr 
move.l 
beq.b 


move. 
move. 
move| 
jsr 
move.| 
beq.b 


move. 
moveq 
jsr 
move. 
beq.b 
move. 


dosname,al 
#0,d0 

4,36 
-552(a6) 
dO,dosbase 
Ende 


dosbase,a6 

#RAW Window .d 
#1005,d2 

-30(a6) 
d0O,WindowHandle 
Ende 


dosbase,a6 
#Flag,d1 
-654(a6) 
dO,DosList 
Ende 
dO,d1 


; Read: Device,Volumes,Assigns 


; OpenLibrary () 


; Mode = OLD 
; OPEN () 
;‚ Handle 


‚ Flags 
; LockDostist () 
; DosList oder Null ? 


; DosList nach D1 
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move. 
moveq 


move.| 
beq.b 
move.| 
move.l 
beq.b 


move.l 
asl.l 
move.l 
move.| 
bsr.b 
lea 
bsr.b 
move,| 
bra.b 


Waät: 
move. 
move.| 
move.l 
jsr 


Ende: 
move.| 


move.| 
jsr 
Ende _O: 
move. 
beq.b 
moveqg 
move.l 
jsr 
Ende_1: 
move.| 
beq.b 
move.| 
move.| 


Jst 
Ende_2: 
rts 


dosbase,a6 


#Flag,d2 ; Flags 

-690(a6) ; NextDosEntry () 
dO,d1 ‚ nächste DosList 

Wait 

d0,a0 

8(a0),d2 ; Task vorhanden ? 
NextDosEntry 

40(a0),dO ; Namen als BPTR 
#2,d0 ‚ mal vier 

d0,a0 ; Adresse des Namen im BPCL-Format 
d1,-(sp) ; aktuelle DosList retten 
printtext ; Namen ausgeben 
TextE,a0 ; Text: AscllI-Code für nächste Zeile 
printtext ; und ausgeben 

(sp)+ ‚d1 ; aktuelle DosList zurück 
NextDosEntry ; und weiter suchen 
#-1,d2 ; Timeout 
WindowHandle,di 

dosbase,a6 

-204(a6) ; WaitForChar () 
WindowHandle,d1 

Ende_O 

dosbase,a6 

-36(a6) ; CLOSE () 

DosList,dO 

Ende _1 

#Flag,d ; Flags: 

DosBase,a6 ;‚ Ab = DosBase 
-660(a6) ; UnLockDostist () 
dosbase,dO 

Ende 2 

dO,al 

4,a6 

-414(a6) 
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;--- Text ausgeben -- - 
i--- AO = Text im BCPL-Format -- - 
PrintText: 

moveq #0,d3 

move.b (a0)+,d3 

beg.b PT _End 

move.l a0,d2 ; Textadresse 


move.| WindowHandle,d! 

move.l dosbase,a6 

jsr -48(a6) ; Write () 
PT_End: 

rts 


RAWWindow: 
dc.b "CON:0/10/200/250/-- DOS-Information ---",O 
even 


dosname: 
dc.b "dos.library",O 
even 


dosbase: 
dc. O 


Dostist: 
dc.| 0 


WindowH andle: 
dc. O0 


TextE: 
dc.b 1,10 
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7.2 Die DOS-Routinen 


Die DOS-Library bietet eine Menge an Funktionen für den Daten- 
transfer. Diese können wir grob in vier Bereiche einteilen: 


1) Ein- und Ausgabe 

2) Dateiverwaltung 

3) Zeitfunktionen 

4) zusätzliche Funktionen 


Wir werden hier nicht auf alle Funktionen eingehen. Das würde den 


Rahmen des Buches sprengen. Die wichtigsten Routinen stellen wir 
Ihnen aber in einer Kurzbeschreibung vor. 


1) Funktionen für die Ein- und Ausgabe 


/n dieser Rubrik gehen wir auf die folgenden Funktionen ein: 


- Open - Seek 

- Close - Input 

- Read - Qutput 

- Write - WaitForChar 
Routine: Open (Name,AccessMode) (D1,D2) 
Offset: -30 


Parameter: D1 = Adresse des Dateinamen 
D2 = Zugriffsmodus auf die Datei 


Modus „unktion 
MODE _OldFile (Wert = 1005) ffnet ein bestehendes Programm 


MODE NewfFile (Wert = 1006) Öffnet ein neues File, das alte wird gelöscht 

MODE Read\Write (Wert = 1004) Öffnet ein altes/neues File - schreiben aber nur von 
einem Task aus 

Rückgabe: =>DO = 0 für Fehler, sonst Adresse einer FileHandle-Struktur (BPTR) 

Erklärung: 

Es wird eine Datei zum Lesen und Schreiben geöffnet. Als Dateinamen kann jedes 

gültige Gerät angegeben werden (RAM:, DHO:, DFO:, etc.). Fällt das Ergebnis positiv 

aus, erhalten wir in DO die Adresse einer FileHandle-Struktur. Die Adresse benötigen 

wir für fast alle Funktionen, um auf die Datei zugreifen zu können. 
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Aufbau der FileHandle-Struktur (44 Bytes) 


N Funkti 
00  fh_Link unbenutzt 
04 fh _Interact wenn <>0, dann ist Datei für Ein- und Ausgaben 
08 fh_ID Nummer der Datei 
12 fh _Buffer Zeiger auf internen Speicher für File 
16  fh_CharPos aktuelle Position für Seek () 
20 fh _End Endposition für Seek () 
24 fh Readfunc Programm, das bei leeren Puffer aufgerufen wird 


28  fh_WriteFunc Programm, das bei vollem Puffer aufgerufen wird 
32 fh _CloseFunc Programm, das beim Schließen des Files aufgerufen wird 
36 fh Args 


40 fh _Arg2 

44 Ende 

Routine: Close (FileHandle) (D1) 
Offset: -36 


Parameter: Di = Adresse der FileHandle-Struktur (BPTR) 

Rückgabe: keine 

Erklärung: 

Diese Funktion schließt eine Datei, die zuvor mit Open () geöffnet wurde und gibt den 
belegten Speicher dem System wieder zurück. Wenn Sie auf eine Datei nicht mehr 
zugreifen, weil Sie z. B. Daten gespeichert haben, müssen Sie diese wieder schließen. 


ee  —  . . ..—.-.—.-.—— -.—..= 


Routine: Read (FileHandle,Buffer,Länge) (D1,D2,D3) 
Offset: -42 
Parameter: D1 = FileHandle-Struktur der Datei (BPTR) 


D2 = Speicher, wo die Daten abgelegt werden sollen 
D3 = Anzahl der zu lesenden Daten 
Rückgabe: =>DO = tatsächliche Anzahl der gelesenen Daten oder Null für Ende 
der Datei oder -1 für Fehler 


Erklärung: 
Über die Funktion Read () können Daten von einem Gerät (Disk, HD, Tastatur) in den 
Speicher gelesen werden. 


ee ee — ._ — — 


Routine: Write (FileHandle,Buffer,Länge) (D1,D2,D3) 
Offset: -48 
Parameter: Di = FileHandle-Struktur der Datei (BPTR) 


D2 = Adresse des Datenpuffers, ab dem die Daten gespeichert werden 
werden sollen. 

D3 = Anzahl der zu schreibenden Daten 
Rückgabe: =>DO = tatsächliche Anzahl der gespeicherten Daten o. -1 für Fehler 
Erklärung: 
Die Funktion schreibt (speichert) Daten auf ein beliebiges Medium. 
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Routine: Seek (FileHandle,Position,Mode) (D1,D2,D3) 
Offset: -66 
Parameter: D1 = FileHandle-Struktur der Datei (BPTR) 

D2 = Anzahl Bytes, um die der Zeiger bewegt werden soll 

D3 = Offset Modus für Berechnung der neuen Position 

Funkti 

Offset_Beginning (-1) Position relativ zum Dateianfang berechnen (D2 = positiv) 
Offset_End (1) Position relativ zum Dateiende berechnen (D2 = negativ) 
Offset Current (0) Position relativ zur aktuellen Position berechnen (D2 = +/-) 
Rückgabe: =>DO = alte Position des Zeigers oder -1 für Fehler 


Erklärung: 

Mit Seek () läßt sich der aktuelle Zeiger innerhalb der Datei auf eine neue Position 
setzen. Es werden keine Bytes in den Speicher geladen. Diese Funktion wird oft für 
Festplattenversionen von Diskettenspielen im Fremdformat genutzt. Es wird dann für 
jede Disk ein File von 880 KByte auf der HD angelegt und die gewünschten Daten 
über Seek () innerhalb des Files angesteuert. 


| A a a Mk a a 


Routine: Input () 


Offset: -54 

Parameter: keine 

Rückgabe: =>DO = FileHandle des aktuellen Eingabekanals (BPTR) 
Erklärung: 


Input liefert uns die FileHandle-Adresse des aktuellen Eingabekanals. In der Regel ist 
das das Shell-Fenster, von dem das Programm gestartet wurde. Hierüber können dann 
Daten über die Tastatur eingelesen werden (Read). 


Routine: Output () 


Offset: -60 

Parameter: keine 

Rückgabe: =>DO = FileHandle des aktuellen Ausgabekanals (BPTR) 
Erklärun 


Output liefert uns die FileHandle-Adresse des aktuellen Ausgabekanals. In der Regel ist 
das das Shell-Fenster, von dem das Programm gestartet wurde. Hierüber können dann 
Daten ausgegeben werden (Write). 


EEE ET Tr Tr TTS nn 


Routine: WaitforChar (FileHandle,TimeOut) (D1,D2) 
Offset: -204 
Parameter: D1 = FileHandle-Struktur des Eingabekanals (BPTR) 


D2 = Anzahl Ticks (50 Ticks = 1 Sekunde) 
Rückgabe: =>DO = Status (O=kein Zeichen, -1=Zeichen empfangen) 
Erklärung: 
Mit dieser Funktion kann eine gewisse Zeit auf die Eingabe eines Zeichens gewartet 
werden. Ist das Ergebnis True (-1), kann man über Read () das Zeichen einlesen. 
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2) Funktionen für die Dateiverwaltung 


In dieser Rubrik gehen wır auf die folgenden Funktionen ein: 


- Lock - GetCurrentDirName - SetFileSize 

- UnLock - GetProgramDir - SetProtection 
- Examine - GetProgramName - DeleteFile 

- ExNext - SetCurrentDir'Name - Rename 

- Info - SetProgramDir - Relabel 

- CreateDir - SetProgramName - Format 

- CurrentDir - SetComment - AssignPath 

- ParrentDir - SetFileDate 

Routine: Lock (Name,Mode) (D1,D2) 

Offset: -84 


Parameter: D1 = Zeiger auf Direktory- oder Filename 
D2 = Zugriffsmodus auf die Datei 


Modus Funktion 

Shared Lock (-2) Zugriff für mehrere Tasks erlaubt 

Access Read (-2) Synonym für Shared Lock 

Exclusive Lock (-1) Zugriff nur für einen Task 

Access _Write (-1) Synonym für Exclusive Lock 

Rückgabe: =>DO = FileLock-Struktur zu den Namen (BPTR) oder Null für Fehler 
Erklärung: 


Mit Lock () meldet man einen Zugriff auf eine Datei oder ein Verzeichnis an. Als 
Ergebnis erhält man die Adresse einer FileLock-Struktur. Diese ist für viele andere 
Funktionen notwendig. 


Aufbau der FileLock-Struktur (20 Bytes) 


N Funktion 
00  *fl_Link Zeiger auf nächsten Lock (BPTR) oder Null für letzten 
04  fl_Key Blocknummer des Direktory oder Files 
08 fl Access Zugriffsmodus (siehe oben) 
12 fl Task Adresse des FileHandler-Task 
16  *fl_Volume Zeiger auf DosList-Struktur (BPTR - siehe oben) 
20 Ende 
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Routine: Unlock (FileLock) (D1) 

Offset: -90 

Parameter: Di = Adresse der FileLock-Struktur (BPTR) 

Rückgabe: keine 

Erklärung: 

Diese Funktion gibt einen Zugriff auf ein Verzeichnis oder File wieder frei und den 
belegten Speicher dem System zurück. 


Mm A Mh a m A Mh Mk A a A A MM Mb ME ak a Mb A Mb mh m mh m 


Routine: Examine (FileLock,FilelnfoBlock) (D1,D2) 
Offset: -102 
Parameter: Di = Adresse der FileLock-Struktur (BPTR) 


D2 = Adresse eines Datenpuffers von 260 Bytes. Die Adresse muß glatt 
durch vier teilbar sein. 
Rückgabe: =>DO = Status (-1=ok, O=Fehler) 


Erklärung: 
Diese Funktion füllt den FilelnfoBlock (260 Bytes) mit Informationen über das Direktory 
bzw. File, welches der FileLock-Struktur entspricht. 


r FilelnfoBlock-S r(2 


00  fib_DiskKey Diskettennummer (Block) 

04  fib_DirEntryTyp Eintragstyp (positiv = Verzeichnis, negativ = Datei) 

08 fib FileName hier folgen 108 Bytes für den Dateinamen (BCPL-String) 
116 fib_Protection Protection-Bits der Datei (siehe Kapitel 3) 

120 fib_Entry Typ Eintragstyp 

124  fib_Size Dateilänge in Bytes 

128 fib_ NumBlocks Anzahl der belegten Blocks 

132 fib_DateStamp ab hier liegt eine DateStamp-Struktur (12 Bytes - s. unten) 
144 fib_Comment Dateikommentar (116 Bytes) 

260 Ende 


Der Speicher (260 Bytes) kann mit der Funktion AllocDosObject () 
reserviert werden. 


Seite 351 


Das Amiga-D Kapitel 7 


Routine: ExNext (FileLock,FilelnfoBlock) (D1,D2) 
Offset: -108 
Parameter: Di = Adresse der FileLock-Struktur (BPTR) 
D2 = Adresse eines Datenpuffers von 260 Bytes. Die Adresse muß glatt 
durch vier teilbar sein. 
Rückgabe: =>DO = Status (-1=ok, O=Fehler) 
Erklärung: 


ExNext sucht den nächsten passenden Eintrag zur FileLock-Struktur und füllt den 
FileinfoBlock mit den entsprechenden Werten. Mit den Funktionen Lock, Examine und 
ExNext läßt sich das Direktory auslesen. Dazu wird einmal ein Lock auf das Gerät 
erzeugt (z.B.: "DHO:",0), danach ruft man einmal Examine () auf und füllt den Filelnfo- 
Block mit den ersten Parametern (RootBlock). Jetzt wird ExtNext () solange aufgerufen, 
bis das Ergebnis Null ist (Ende des Direktory). Möchte man ein Unterverzeichnis 
auflisten, muß erst ein Lock darauf erzeugt werden und danach kann man wie eben 
beschrieben das Verzeichnis auslesen. 


Routine: Info (FileLock,InfoData) (D1,D2) 
Offset: . I 
Parameter: = Adresse der FileLock-Struktur (BPTR) 
D2 = Adresse eines Datenpuffers von 36 Bytes. Die Adresse muß glatt 
durch vier teilbar sein. 
Rückgabe: =>DO = Status (-1=ok, O=Fehler) 
Erklärung: 


Füllt den InfoData-Block mit Informationen über die Diskette bzw. die Festplatte (Files, 
Dir, etc.) 


Aufbau der InfoData-Struktur (36 Bytes) 


t Name Funktion 
00 id Nums$oftErrors Anzahl der Fehler auf der Disk/Partition 
04 id UnitNumber Unit-Nummer für dieses Gerät 
08 id _DiskState Diskettenstatus 


Status Funktion 

ID_ WRITE _PROTECTED (Wert = 80) Disk ist schreibgeschützt 
ID VALIDATING (Wert = 81) unvalidierte Bitmap 
ID_VALIDATED (Wert = 82) alles in Ordnung 


12 id NumßBlocks Anzahl der Blöcke für diese Disk/Partition 

16 id _NumßBlocksused Anzahl der belegten Blocks 

20 id_BytesPerBlock Anzahl der Bytes pro Block (512 Bytes) 

24 id _DiskType Diskettentyp - siehe Aufbau der DevList-Struktur 
28  *id VolumeNode Zeiger auf DosList-Struktur (BPTR) 

32 id_InUse O0 = Gerät nicht aktiv 

36 Ende 
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Routine: CreateDir (Name) (D1) 

Offset: -120 

Parameter: Di = Zeiger auf Namen des Direktories 

Rückgabe: =>DO = FileLock-Struktur (BPTR) für angelegtes Verzeichnis oder 


Null für Fehler 
Erklärung: 
CreateDir erzeugt ein neues Verzeichnis in dem angegebenen Pfad. Ist das Ergebnis 
positiv, wird eine FileLock-Struktur mit exclusiven Zugriff zurückgegeben. Vergessen Sie 
nicht den Lock auf das Direktory wieder mit Unlock () freizugeben. 


Routine: CurrentDir (FileLock) (D1) 

Offset: -126 

Parameter: D1 = FileLock-Struktur des neuen Verzeichnis (BPTR) 
Rückgabe: =>DO = alte FileLock-Struktur für vorheriges Direktory (BPTR) 
Erklärung: 


Mit CurrentDir () kann ein Zugriff (Lock) auf ein Direktory angemeldet werden. Die 
Funktion ist vergleichbar mit dem CD-Befehl der Shell. Als Ergebnis bekommen wir die 
FileLock-Struktur des alten aktuellen Verzeichnis. 
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Routine: ParentDir (FileLock) (D1) 

Offset: -210 

Parameter: D1 = FilelLock-Struktur des aktuellen Verzeichnis (BPTR) 

Rückgabe: =>DO = FileLock-Struktur (BPTR) des übergeordneten Verzeichnis 


oder Null für Hauptverzeichnis (RootBlock) 
Erklärung: 
Mit ParentDir () kann das übergeordnete Verzeichnis eines Direktories bzw. Files 
ermittelt werden. Als Ergebnis erhalten wir die FileLock-Struktur des übergeordneten 
Verzeichnis oder Null, wenn wir uns schon im Hauptverzeichnis befinden. 


Routine: GetCurrentDirName (Buffer,Length) (D1,D2) 

Offset: -564 (ab V36) 

Parameter: D1 = Datenpuffer, der den aktuellen Direktory-Namen aufnehmen soll 
D2 = Größe des Datenpuffers (maximale Anzahl Zeichen) 

Rückgabe: =>DO = Status (-1=OK, O=Fehler) 

Erklärung: 

Diese Funktion ermittelt den aktuellen Pfad und kopiert den Namen in den 

Datenpuffer, Ist der Name länger als in D2 angegeben oder exestiert keine interne CLI- 

Struktur, wird ein Fehler signalisiert (DO=0). 
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Routine: GetProgrambDir () 

Offset: -600 (ab V36) 

Parameter: keine 

Rückgabe: =>DO = FileLock-Struktur vom Direktory, von dem das Programm 


gestartet wurde (BPTR) oder Null für Fehler 
Erklärung: 
Diese Funktion erzeugt ein Lock auf das Direktory, von dem das Programm, welche 
diese Funktion aufruft, geladen wurde. Falls das Programm resident vorlag oder 
andere Gründe keinen Lock ermöglichen, wird eine Null zurückgegeben. 


Routine: GetProgramName (Buffer Length) (D1,D2) 

Offset: -576 (ab V36) 

Parameter: Di = Datenpuffer, der den aktuellen Prgramm-Namen aufnehmen soll 
D2 = Größe des Datenpuffers (maximale Anzahl Zeichen) 

Rückgabe: =>DO = Status (-1=0OK, O=Fehler) 

Erklärung: 

Diese Funktion ermittelt den zum Programm gehörenden Filename und kopiert diesen 

in den Datenpuffer. Hier gilt das Gleiche, wie unter GetCurrentDirName beschrieben. 


Routine: SetCurrentDirName (Name) (D]) 

Offset: -558 (ab V36) 

Parameter: DI = Zeiger auf Namen des Direktory-Pfad 
Rückgabe: =>DO = Status (-1=0K, O=Fehler) 
Erklärung: 


SetCurrentDirName setzt einen neuen Namen des Verzeichnispfades in der internen 
CLI-Struktur. Bei einem Fehler wird eine Null zurückgegeben. 
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Routine: SetProgramDir (FileLock) (D1) 

Offset: -594 (ab V36) 

Parameter: DI = FileLock-Struktur (BPTR) des Direktory für ein Programm 
Rückgabe: =>DO = FileLock-Struktur (BPTR) des alten Direktory für Programm 
Erklärung: 


Diese Funktion meldet einen Lock für ein Verzeichnis an. Jetzt werden alle Daten für 
ein Programm aus diesem Verzeichnis geladen. Als Ergebnis wird die alte FileLock- 
Struktur, von dem die Daten zuvor geholt wurden, zurückgegeben. 


Routine: SetProgramName (Name) (D1) 

Offset: -570 (ab V36) 

Parameter: Di = Zeiger auf Namen vom Programm 
Rückgabe: =>DO = Status (-1=OK, O=Fehler) 
Erklärung: 


SetProgramName setzt den Namen des Programms neu in der CLI-Struktur. Wenn der 
Name zu lang ist oder es liegen andere Gründe vor, wird ein Fehler gemeldet. 
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Routine: SetComment (Name,Comment) (D1,D2) 
Offset: -180 
Parameter: Di = Zeiger auf Filename (vollständiger Pfad) 
D2 = Zeiger auf Kommentarstring (max. 80 Bytes) 
Rückgabe: =>DO = Status (-1=OK, O=Fehler) 
Erklärung: 
Mit SetComment () kann der Kommentar zu einem File geändert werden. Der 
Kommentar darf maximal 80 Zeichen lang sein. Mehr Informationen finden Sie im 
Kapitel 3. 
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Routine: SetFfileDate (Name ,DateStamp) (D1,D2) 
Offset: -396 (ab V36) 
Parameter: Di = Zeiger auf Filename 

D2 = Adresse einer DateStamp-Struktur, die das neue Datum enthält 
Rückgabe: =>DO = Status (-1=OK, O=Fehler) 
Erklärung: 
SetFileDate () setzt das Erstellungsdatum eines Verzeichnis/File neu. Im FFS und OFS 
kann man das Datum des Root-Verzeichnisses nicht ändern. Die DateStamp-Struktur 
enthält drei Long-Einträge, die das neue Datum enthalten. 


Au r Stam r(12 
00 ds Days Anzahl Tage seit dem 1.1.78 
04 ds_Minute Anzahl Minuten seit 00 Uhr 
08 ds Tick Anzahl Ticks (50 Ticks = 1 Sekunde) 


12 Ende 


a 


Routine: SetFileSize (fh,Offset,Mode) (D1,D2,D3) 
Offset: -456 (ab V36) 
Parameter: D1 = FileHandle-Struktur vom File (BPTR) 

D2 = Anzahl Bytes um die das File vergrößert/verkleinert werden soll 

D3 = Offset-Modus (siehe Seek-Funktion) 

-1 = Anzahl Bytes am Anfang einfügen 

1 = Anzahl Bytes am Ende einfügen 

0 = Anzahl Bytes ab aktuelle Seekposition einfügen 
Rückgabe: =>DO = neue Position des Seek-Zeigers oder -1 für Fehler 
Erklärung: 
Mit SetFileSize () läßt sich die Länge eines Files ändern. Die neue Seekposition ist 
Abhängig vom Filesystem. Das Beste ist, Sie berechnen diese neu mit der Seek- 
Funktion. 
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Routine: SetProtection (Name,Mask) (D1,D2) 
Offset: -186 
Parameter: DI = Zeiger auf Filename 
D2 = Maske mit den neuen Protection-Bits (siehe Kapitel 3) 
Rückgabe: =>DO = Status (-1=OK, O=Fehler) 
Erklärung: 
Mit SetProtection () lassen sich die Protection-Bits ändern. In Maske werden die 
gewünschten Bits gesetzt (siehe Kapitel 3). 
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Routine: DeleteFile (Name) (D1) 

Offset: -72 

Parameter: DI = Zeiger auf File/Dirname 
Rückgabe: =>DO = Status (-1=OK, O=Fehler) 
Erklärung: 


DeleteFile löscht ein File/Dir von Diskette/HD. Es können nur leere Verzeichnisse 
gelöscht werden. 
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Routine: Rename (OldName,NewName) (D1,D2) 
Offset: -78 
Parameter: D1 = Zeiger auf alten File/Dirname 


D2 = Zeiger auf neuen File/Dirname 
Rückgabe: =>DO = Status (-1=OK, O=Fehler) 
Erklärung: 
Mit Rename können Files oder Verzeichnisse umbenannt werden. Als neuen Namen 
kann man auch einen anderen Pfad angeben. Das Verzeichnis bzw. File wird dann 
verschoben (Move). 


Routine: Relabel (VolumeName,Name) (D1,D2) 

Offset: -720 (ab V36) 

Parameter: Di = Zeiger auf Volumenamen mit ":* (z.B.: "Workbench:",O) 
D2 = Zeiger auf neuen Volumenamen ohne ":* (z.B.: "Spiele" ,O) 

Rückgabe: =>DO = Status (-1=0K, O=Fehler) 

Erklärung: 

Relabel ändert den Namen eines Volumes (Disk, Partition, etc.). 


Routine: Format (Filesystem, VolumeName,DosType) (D1,D2,D3) 
Offset: -714 (ab V36) | 
Parameter: D1 = Zeiger auf Devicename mit ":* (z.B.: "DHO:",O) 
D2 = Zeiger auf Volumename ohne *:" (z.B.: "Workbench",0) 
D3 = Format des Filesystems (siehe Aufbau DevList - Wert) 
Rückgabe: =>DO = Status (-1=OK, O=Fehler) 
Erklärung: 
Format initialisiert eine leere Disk-Struktur auf ein Device. Das Device darf sich nicht in 
Benutzung befinden (s. Funktion Inhibit - Includes). 
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Routine: AssignPath (Name,Path) (D1,D2) 
Offset: -624 (ab V36) 
Parameter: Di = Zeiger auf Device, welches Assigned werden soll ohne *:" 
(z.B.: "DHO:c",O) 

D2 = Zeiger auf Reference-Device für Assign (z.B.: "DH3:c",O) 
Rückgabe: =>DO = Status (-1=OK, O=Fehler) 
Erklärung: 
Mit AssignPath () kann ein Pfad zur Systemliste assigned werden. Die Funktion 
entspricht der des Assign-Befehl von der Shell. Für unser obiges Beispiel würde der 
Assign-Befehl lauten: "Assign DHO:c to DH3:c" 


3) Zeitfunktionen für Amiga-DOS 
/n dieser Rubrik gehen wır auf die folgenden Funktionen ein: 
- DateStamp - StrToDate 


- DateToStr - Delay 


Routine: DateStamp (DateStamp) (D1) 


Offset: -192 

Parameter: D1 = Zeiger auf eine leere DateStamp-Struktur (12 Bytes) 
Rückgabe: =>DO = Adresse der DateStamp-Struktur von D1 
Erklärung: 


DateStamp () füllt die übergebene DateStamp-Struktur mit der aktuellen Zeit. Ist die 
Zeit noch nicht initialisiert, wird die Struktur mit drei Null-Longwords gefüllt. Den 
Aufbau können Sie der Beschreibung für die SetFileDate-Funktion entnehmen. 
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Routine: DateToStr (DateTime) (D1) 

Offset: -744 (ab V36) 

Parameter: Di = Zeiger auf eine DateTime-Struktur (26 Bytes) 
Rückgabe: =>DO = Status (-1=OK, O=Fehler) 

Erklärung: 


DateToStr () wandelt die Werte in der DateTime-Struktur, in Abhängigkeit der 
Parameter, in ASCII-Texte. 
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Aufbau der DateTime-Struktur (26 Bytes) 


Offset Name Funktion 

00 dat _Days Anzahl Tage seit dem 1.1.78 

04 dat Minute Anzahl Minuten seit 00 Uhr 

08 dat Tick Anzahl Ticks (50 Ticks = 1 Sekunde) 
12 dat Format Ausgabeformat vom Datum 


Format_DOS [dd-mmm-yy] 

1 = Format_INT [yy-mm-dd] 

2 = Format _USA [mm-dd-yy] 
3 = Format _CDN [dd-mm-yy] 

13  dat_Flags Bit O (SUBST) = Begriffe: Today, Tomorrow etc. erlauben 
Bit 1 (Future) = "day of the week is in future" ausgeben 

14 dat StrDay Zeiger auf ASCII-Puffer für Tag-String ("Monday") oder 
Null, wenn dieser nicht genutzt werden soll (CPTR) 

18 dat StrDate Zeiger auf ASCII-Puffer für Datum-String ("09-22-95*) oder 
Null, wenn dieser nicht genutzt werden soll (CPTR) 

22 dat StrTime Zeiger auf ASCII-Puffer für Zeit-String oder 
Null, wenn dieser nicht genutzt werden soll (CPTR) 


26 Ende 


Möchten Sie die aktuelle Zeit in ASCII-Form auslesen, müssen Sie 
einfach folgende Schritte durchführen: 


1) DateTime-Struktur anlegen 

(dat_Format u. Stringpointer auf 100 Byte-Puffer setzen) 
2) Funktion DateStamp () aufrufen 

(D1 = Adresse der DateTime-Struktur) 
3) Funktion DateToStr () aufrufen 

(D1 = Adresse der DateTime-Struktur) 


=> Jetzt liegen die gewünschten ASCII-Daten in den Puffern von 
jeweils 100 Bytes. 
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Routine: StrToDate (DateTime) (D1) 

Offset: -750 (ab V36) 

Parameter: Di = Zeiger auf eine DateTime-Struktur (26 Bytes) 
Rückgabe: =>DO = Status (-1=OK, O=Fehler) 

Erklärun 


StrToDate () wandelt den "StrDate"-Eintrag in ein dat Days-Wert und den "StrTime"- 
Eintrag in die dat Minute und dat _Tick-Werte. Ist ein Stringpointer Null, wird dieser 
ignoriert. Wird kein Format in dat Format eingetragen, ist immer das DOS-Format 
aktiv. Das Future-Bit in dat Flags hat hier als einziges Bit eine Auswirkung. Ist es 
gesetzt, wird ein Tag auf den nächsten, ist es gelöscht, auf den vorherigen Tag 
bezogen. 
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Routine: Delay (Ticks) (D1) 
Offset: -198 


Parameter: Di = Anzahl Ticks, die gewartet werden soll (50 Ticks = 1 Sekunde) 
Rückgabe: keine 


Erklärung: 
Mit Delay kann eine gewisse Zeit gewartet werden. Das Programm muß solange 
warten, bis die Zeit abgelaufen ist. 


4) Zusätzliche Funktionen Amiga-DOS 


/n dieser Rubrik gehen wir auf die folgenden Funktionen ein: 


- Execute - PrintFault 

- IOErr - Exit 

Routine: Execute (CommandString,Input,Output) (D1,D2,D3) 

Offset: -222 

Parameter: Di = Zeiger auf Filename v Programm, welches ausgeführt werden soll 
D2 = FileHandle-Struktur (BPTR) für Eingabekanal oder Null 
D3 = FileHandle-Struktur (BPTR) für Ausgabekanal oder Null 

Rückgabe: => DO = Status (O=Fehler, -1=OK) 


Erklärung: 

Mit Execute () kann ein beliebiges Programm ausgeführt werden. Die Ein- und 
Ausgabekanäle kann man vorher definieren oder den Wert Null übergeben, für 
aktuelle Kanäle benutzen. 
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Routine: IOErr () 

Offset: -132 

Parameter: keine 

Rückgabe: => DO = Fehlernummer des letzten Operation 
Erklärung: 


Mit IOErr () kann ein fehlerhafter Rückgabewert einer Funktion näher untersucht 
werden. Sobald eine Funktion einen Fehler meldet, kann man durch Aufrufen von 
IOErr () die genaue Fehlernummer erfragen. Welche Fehlernummern es gibt, darauf 
gehen wir in Abschnitt 7.3 ein. 


Routine: PrintFault (Code,Header) (D1,D2) 
Offset: -474 (ab V36) 
Parameter: Di = Fehlernummer (von IOErr) 

D2 = Zeiger auf einen Text, der vor dem Errortext ausgegeben 

werden soll. 

Rückgabe: => DO = Status (O=Fehler, -1=OK) 
Erklärung: 
Mit PrintFault () wird die Fehlernummer in D1 als ASCII-Text auf den aktuellen 
Ausgabekanal ausgegeben. In D2 kann man noch einen Anfangstext übergeben, der 
als erstes ausgegeben wird. 


Routine: Exit (ReturnCode) (D1) 
Offset: -144 

Parameter: Di = Rückgabewert für DO 
Rückgabe: keine 


Erklärung: 
Mit dieser Funktion beendet man Programme, die in der Sprache BCPL programmiert 


wurden (Vorgänger von "C"). Für alle anderen Sprachen (C, Assembler) ist Exit () 
unwichtig und sollte nicht zum Beenden des Programms aufgerufen werden. 


7.3 Die DOS-Fehlermeldungen 


Wie wir schon erfahren haben, liefert uns die Funktion IOErr () eine 
jenaue Fehlerbezeichnung der letzten Fehlfunktion. Es folgt jetzt eine 
Übersicht der Nummern und Bezeichnungen. 
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Fehlerbezeichnung Fehlernummer 
ERROR_NO FREE STORE = 903 
ERROR_TASK_TABLE FULL = 105 
ERROR_ BAD _ TEMPLATE = 1714 
ERROR_ BAD _NUMBER = E15 
ERROR_ R=IRED _ARG_MISSING = 116 
ERROR_ KEY_ NEEDS_ ARG = 117 
ERROR_ TOO. MANY_ ARGS = 118 
ERROR_ UNMATCHED _ QUOTES = 119 
ERROR_ LINE TOO_LONG = 120 
ERROR. FILE NOT _ OBJECT = 121 
ERROR_INVALID RESIDENT LIBRARY = 122 
ERROR_NO_DEFAULT_DIR = 201 
ERROR _OBJECT_IN USE = 202 
ERROR_OBJECT_EXISTS = 203 
ERROR_DIR_NOT_FOUND = 204 
ERROR_OBJECT_NOT_FOUND =: 205 
ERROR _BAD_STREAM_NAME = 206 
ERROR. _ OBJECT. TOO_ LARGE = 207 
ERROR _ACTION _NOT_ KNOWN = 209 
ERROR _INVALID COMPONENT NAME = 210 
ERROR_INVALID_LOCK = 211 
ERROR OBJECT _WRONG TYPE = 212 
ERROR_DISK_NOT_VALIDATED = 213 
ERROR _DISK_WRITE_PROTECTED = 214 
ERROR _RENAME ACROSS_DEVICES = 215 
ERROR DIRECTORY _NOT_EMPTY = 216 
ERROR _TOO_MANY_LEVELS = 212 
ERROR_DEVICE_NOT_MOUNTED = 218 
ERROR_SEEK_ ERROR = 219 
ERROR. COMMENT. TOO _BIG = 220 
ERROR_ DISK_FULL = 221 
ERROR. DELETE PROTECTED = 222 
ERROR _WRITE_PROTECT ED = 223 
ERROR READ_PROTECTED = 224 
ERROR _NOT_A_DOS_DISK = 225 
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ERROR_NO_DISK = 226 
ERROR NO MORE ENTRIES = 232 
ab V36 —- 

ERROR_IS_SOFT_LINK = 233 
ERROR OBJECT _LINKED = 234 
ERROR BAD _HUNK = 235 
ERROR NOT _IMPLEMENTED = 236 
ERROR RECORD _NOT LOCKED = 240 
ERROR LOCK COLLISION = 241 
ERROR _LOCK_TIMEOUT = 242 
ERROR UNLOCK ERROR = 243 
ERROR _BUFFER OVERFLOW = 303 
ERROR BREAK = 304 
ERROR _NOT_EXECUTABLE = 305 


7.4 Aufbau von Programmen 


Das waren noch Zeiten auf den alten 8-Bittern. Jedes Programm lag 
immer bei einer festen Adresse, der Speicherbereich hatte eine feste 
Größe usw.. 


Seit dem Amiga sieht die Sache etwas anders aus. Bedingt durch das 
Multitasking, kann jedes Programm an einer beliebigen Adresse im 
Speicher beginnen. Mit festen Programmadressen würde man da 
nicht weit kommen. Es wurden die sogenannten Hunks eingeführt. 
Der Aufbau läuft nach dem gleichen Prinzip des IFF-Standards ab. Es 
gibt verschiedene Hunk-Typen, die die notwendigen Daten für ein 
Programm enthalten. Die wichtigsten sind wohl der Code- und Reloc- 
Typ. Diese enthalten den eigentlichen Programmteil und die 
Adressen, welche auf die aktuellen korrigiert werden müssen. 
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Nähere Informationen finden Sie in den Includes oder in 
entsprechender DOS-Literatur. Eine ausführliche Beschreibung würde 
auch hier zu weit führen. 


7.5 Der richtige Programmstart 


Der Amiga bietet zwei Arten ein Programm zu starten. Entweder von 
der Shell (CLI) oder der Workbench. Wird das Programm von der 
Shell gestartet, wird in AO die Adresse der Parameterzeile und in DO 
die Anzahl Zeichen übergeben. Ein Start über die Workbench ist ein 
wenig komplizierter. 


Programm Ü ie Workbench 


Wird das Icon von einem Programm angeklickt, so führt der Amiga 
das dazugehörige Programm aus und übergibt diesem eine Startup- 
Message (WB-Startup). Sie enthält einige Einträge, um die wir uns 
aber nicht zu kümmern brauchen. Wichtig ist nur, daß die Message 
auch gleich vom Programm geholt wird, andernfalls könnte im 
Verlaufe des Programmes der Guru meditieren... 


Verarbeiten der WBStartup-Message 


Zu Beginn müssen wir erstmal feststellen, ob das Programm von der 
Shell oder der Workbench gestartet wurde. Dafür brauchen wir die 
Processadresse von unserem eigenen Programm - über die Exec- 
Funktion FindTask () erhalten wir diese. Ab Offset 172 befindet sich 
ein CLI-Zeiger oder nicht, dementsprechend können wir weiter 
vorgehen. Existiert kein Zeiger, wurde unser Programm von der 
Workbench gestartet und wir können mittels WaitPort () auf die 
WBStartup-Message warten. Die Portadresse erhalten wir über den 
Offset 92 ($5C). Ist die Message endlich angekommen, holen wir sie 
mit der Funktion GetMsg (). Das war schon alles. Ob wir die Message 
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(Nachricht) auswerten oder nicht, liegt an uns. 


Beispiellisting für einen 100%igen Programmstart. Diese Zeilen nur 
in Ihrem Listing einfügen, wenn sie das Programm nicht vom 
Assembler aus starten. 


movem.| dO/a0,-(sp) ; Shell-Paramter retten 
sub. al,al ; eigenen Task 
move.l 4,36 ; Execbase 
jsr -294(a6) ; FindTask () 
sub.| al,al ; keine WBCLIMessage 
move.| dO,a2 ; Process-Adresse nach A2 
tst.| $ac(a2) ; kommen wir vom CLI ? 
bne CL ; ja, dann CLI 
lea $5c(a2),a0 ; MsgPort nach a0 
jsr -384(a6) ; WaitPort () 
lea $5c(a2),a0 
jsr -372(a6) ; GetMsg () 
move.| dO,al ; WB_Startup nach al 
move.|l $1c(a1),dO ; Anzahl => dO 
move.l $24(a1),a0 ‚ Liste => a0 
addq.w #8,sp ; Stack korrigieren 
bra WB 
EL 
movem.| (sp)+ ,‚dO/a0 ; Shell-Paramter zurück 
WB: 
move.l a1,WBCLIMessage ; Message retten 


;- ab hier steht eigenes Programm --- 


' 


Exit: 
move.|l \WBCLIMessage,al 
move.|l al,dı ; kamen wir von WB ? 
beq.s Exit 1 ; nein, dann Exit_] 
move.| 4,36 
Isr -378(a6) ; ReplyMsg () 
Exit 1: 
moveq #0,d0 
rts ; Programmende 


WBCLIMessage: dc.1 0 
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7.6 Ein- und Ausgaben 


Das Amiga-DOS bietet neben den normalen Read- und \Write- 
Funktionen auf Files, auch die Möglichkeit auf andere Geräte wie 
Drucker, Modem usw. Daten auszugeben. Als weitere Ein- und 
Ausgabekanäle stehen einem folgende Bezeichnungen zur Auswahl: 


NIL: (Datengrab) 

Alle Daten die über diesen Kanal laufen, gehen verloren. Nützlich für 
unwichtige Ausgaben von Daten, ohne dabei Speicher zu belegen. 
SER:/PAR: 

Durch diese Kanäle können Daten über die parallele (PAR) und 
serielle (SER) Schnittstelle ein- und ausgegeben werden. Alle 
notwendigen Parameter für den Datentransfer bezieht das Amiga-DOS 
aus den Preferences-Einstellungen. 

PRT: (Prin 

Über diesen Kanal kann man Daten an den Drucker senden. In der 
Regel ist der Drucker an der parallelen Schnittstelle (PAR) ange- 
schlossen und kann somit auch über "PAR:" angesteuert werden. 

“ Il r 


Das "Sternchen" steht für das aktuelle Fenster, von dem z. B. das 
Programm gestartet wurde (Shell). 
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CON:/RAW: (Fenster) 


Mit diesen Bezeichnungen wird zusätzlich ein Fenster für die Ein- und 
Ausgabe geöffnet. Um solche Fenster öffnen zu können, muß der 
DOS-Funktion Open () als Name in D1 folgende Befehlszeile überge- 
ben werden. 


1) "CON:X/Y/B/H/Name",O 
oder 


2) "RAW:X/YI/B/IH/Name",O 


horizontale Position der linken oberen Ecke vom Fenster 
vertikale Position der linken oberen Ecke vom Fenster 
Breite des Fensters in Pixel 

Höhe des Fensters in Zeilen 

ame = Titel des Fensters 


X 
Y 
B 
H 
N 


Der Unterschied zwischen einem CON- und RAW-Fenster bezieht sich 
auf das Einlesen von Daten. Das CON-Fenster ließt solange Daten ein, 
bis die ENTER-Taste gedrückt wird. Das RAW-Fenster kehrt sofort 
zurück. Mit dem CON-Fenster können schon recht komfortabel Ein- 
und Ausgaben auf einem Fenster verwaltet werden. Über das RAW- 
Fenster lassen sich dafür alle Tasten abfragen (auch Sondertasten). 


Den beiden Fensterarten können auch noch Steuersequencen 
übermittelt werden, die bestimmte Funktionen auslösen. Der Wert in 
Anführungszeichen wird als ASCII-Code angegeben. 
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EEE ae ER. a isn eek 


$08 

$0A 

$0B 

$0C 

$0D 

$0E 

$OF 

$1B 
$9B,"n",$40 
$9B,"n",$41 
$9B,"n",$42 
$9B,"n",$43 
$9B,"n",$44 
$9B,"n",$45 
$9B,"n",$46 


$9B,"n",$3B,"n",$48 


$9B,$4A 
$9B,$4B 
$9B,$4C 
$9B,$4D 
$9B,"n",$50 
$9B,"'n",$53 
$9B,"n",$54 


$9B,$32,$30,$68 
$9B,$32,$30,$6C 


$9B,$6E 


$9B,"n;3n;4n",$6D 


$9B,"n",$74 
$9B,"n",$75 
$9B,"n",$78 
$9B,"n",$79 


$98,$30,$20,$70 


$98,$20,$70 
$9B,$71 


Backspace 

Linefeed (Cursor eine Zeile runter) 

Cursor eine Zeile hoch 

Fenster löschen 

Carriage Return (Cursor auf erste Spalte, der gleichen Zeile) 
normale Zeichendarstellung 

Sonderzeichendarstellung 

Escape (ESC) 

n Leerzeichen einfügen 

Cursor um n Zeilen hoch 

Cursor um n Zeilen runter 

Cursor um n Spalten nach rechts 

Cursor um n Spalten nach links 

Cursor um n Spalten runter und in erste Spalte 

Cursor um n Spalten hoch und in erste Spalte 

Cursor in Zeile,Spalte setzen 

Fenster ab Cursorposition löschen 

Zeile ab Cursorposition löschen 

Zeile einfügen (ab Cursor) 

Zeile löschen (ab Cursor) 

n Zeichen ab Cursorposition löschen 

n Zeilen hochschieben 

n Zeilen runterschieben 

beim Linefeed auch Return auslösen (Cursor runter und auf 
erste Spalte) 

beim Linefeed kein Return zusätzlich (Cursor nur runter) 
Cursorposition senden. Mit Read () kann folgende Sequenz 
eingelesen werden: 

$9B,"Z",$3B,"S",52 (Z=Zeile, S=Spalte) 

Zeichenstyle und Farben setzen: 

n = Style 

(0=Normal, 1=Fett, 3=Schräg, 4=unterstrichen, 7 =Invers) 
3n = 30 bis 37 (Textfarbe O bis 7) 

4n = 40 bis 47 (Hintergrundfarbe O bis 7) 

Anzahl der Zeilen für das Fenster festlegen 

Anzahl der Spalten für das Fenster festlegen 

Abstand der Textausgabe zum linken Fensterrand in Pixel 
Abstand der Textausgabe zum oberen Fensterrand in Pixel 
Cursor ausschalten (unsichtbar) 

Cursor einschalten (sichtbar) 

Fensterausmaße senden. Mit Read () kann folgende Sequenz 
eingelesen werden: 
$9B,$31,$38,$31,$3b,"2",$3B,"S",$73 

Z = Anzahl Zeilen S = Anzahl Spalten 
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7.7 Beispielprogramme 


Zum Abschluß noch drei Beispiellistings. Das Erste liest mittels der 
Funktionen Lock, Examine und ExNext das Inhaltsverzeichnis der 
Diskette im Laufwerk DFO aus. Das zweite ermittelt den aktuellen 
Programmpfad, von dem das Programm gestartet wurde und gibt in 
DO die Adresse des vollständigen Pfads zurück. Dieser ist zum Beispiel 
wichtig für die ASL-Library (Direktory). Bei dem dritten Beispiel 
handelt es sich um DOS-Routinen zum Laden und Speichern von 
Daten (Umsetzung der Hardwarebeispiele aus Kapitel 4). 


ec |. .—— 


move.| 4,36 


lea dosname,al ; dos.library 
moveq #0,d0 ; Version: egal 
jsr -552(a6) ; OpenlLibrary () 
move.| dO,dosbase 
bne ok 
moveq #0,d0 
rts ; Programmende 
ok: 
move.|l #FensterName,di 
move.| #1005,d2 
move.l dosbase,a6 
jsr -30(a6) ; Open () 
tst.l dO ; konnte Fenster geöffnet werden ? 
beq End 
move.|l  dO,ConHandle 
bsr Dir ; Dir einlesen u. ausgeben 
Wart: 
btst #10,$dff0 16 ; auf rechte Maustaste warten 
bne Wart 
move.l| ConHandle,di ; FensterHandle 
move.|l dosbase,a6 
jsr -36(a6) ; Close () 
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4,36 
dosbase,a1 
-414(a6) 
#0,d0 


; CloseLibrary () 


; Programmende 


jsr 

tst.| 

beq 
DirPrint: 

lea 

adda.| 

bsr 

lea 

bsr 

bra 
DirError: 

move.l 

beq 

jsr 

move.l 
DirError_2: 

jsr 

rts 


Examine, ExNext und PrintText --- 


dosbase,a6 
Titel,a0 
PrintText 


#DirName,d! 
#-2,d2 
-84(a6) 
dO,LockSav 
DirError 


LockSav,d1i 
#FilelnfoBlock,d2 
-102(a6) 

dO 

DirError 

DirPrint 


LockSav,d1 
#FilelnfoBlock,d2 
-108(a6) 

dO 

DirError 


FileinfoBlock,a0 
#8,a0 

Printtext 
TextEnter,a0 
PrintText 
DirLoop 


LockSav,d1 
DirError_2 
-90(a6) 
#0,LockSav 


-132(a6) 


‚ DosBasıs für PrintText 
; und restlichen Funktionen 


AD 

; Modus: Read 

; Lock () 

; FileLock-Struktur (BPTR) 


; FileLock-Struktur (BPTR) 
; FilelnfoBlock (260 Bytes) 
; Examine () 

; Fehler ? 


; ExNext () 
; Dir-Ende ? 


; FileName (BCPL) 


; Unlock () 


; IOErr (Q) 
; Fehlernummer in DO 
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;--- Text ausgeben == 
;--- AO = Text mit Null-Byte -- - 
;--- A6 = DosBasis —— 
PrintText: 

moveq #0,d3 

move.|l a0,d2 ; Textadresse 
PT_Loop: 

tst.b (a0) + 

beq PT 2 

addq.| #1,d3 ‚ Länge +] 

bra PT_Loop 
PT_Z£: 

move.|l ConHandle,d1 

jsr -48(a6) ; Write () 

rts 
;--- Parameter --- 
cnop 0,4 ; Adresse muß durch vier teilbar sein 
FilelnfoBlock: bik.b 260,0 ‚ 260 Bytes 


DirName: dc.b "DFO:",O 
even 


LockSav: dc.I 0 
ConHandle: dc.| O 


dosbase: 

dc.| 0 
dosname: dc.b "dos.library",O 
even 


FensterName: dc.b "CON:0/10/640/256/** Dir ***",O 
even 


Titel: dc.b "Directory",10,0 
even 

TextEnter: dc.b 10,0 
even 
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;--- Beispiel zum ermitteln des aktuellen Pfads --- 
lea dosname,al 
moveq #0,d0 
move.| 4,36 
jsr -552(a6) 
move.| dO,dosbase 
beq Ende 

bsr GetDir 
move.l dO,Test 

Ende: 
move.| dosbase,dO 
beq Ende_1 


move.| dO,al 
move.| 4,36 


jsr -414(a6) 
Ende _1: 

move.| Test,dO 

rts 
Test: dc.! O 


dosname: dc.b "dos.library",O 


even 
dosbase: dc.| O 


j--- Aktuellen Pfad auslesen, von wo Prg. aufgerufen wurde --- 
;--- => DO = Pfad, oder Null für Error --- 
GetDir 

move.l #fFreeName,di ; Null für aktuellen Lock 


moveq #-2,d2 

move.|l dosbase,a6 

jsr -84 (a6) ; GetDirLock 
move.l dO,GetDirLock 

beq GetDir_Error 


lea DirNamePufferEnd,a0 
lea GetDirInfoBGetDirLock,al 


Seite 371 


Das Amiga-DOS Kapitel 7 


GetDir_Start: 
move.l GetDirLock,d1 
move.| al,d2 
move.| dosbase,a6 
movem.| a0-al,-(sp) 


jsr -102(a6) ; Examine 
movem.| (sp)+ ‚a0-al 
tst.| dO 
beq GetDir Error 
lea 8(a1),a2 
movegq #107,d7 
movegq #0,d6 
GetDir NameEnde: 
tst.b (a2) 
beq GetDir NameEndeOK 
addq.w #1,a2 
addq.w #1,d6 
dbra d7 ,GetDir_NameEnde 
bra GetDir_Error 
GetDir NameEndeOk: 
tst.w d6 
beq GetDir Error 
subq.w #1,d6 


move.l a0,a3 

move.b #"/",-(a0) 
GetDir Copy: 

move.b -(a2),-(a0) 

dbra d6,GetDir Copy 

movem.| a0-a1l/a3,-(sp) 

move.l dosbase,a6 

move.| GetDirLock,d1 


jsr -210(a6) ; ParentDir () 
movem.| (sp)+ ‚a0-al/a3 
tst.| 0 


beq GetDir Ende 
movem.| a0-al,-(sp) 
move.|l  GetDirLock,di 
move.l dO,GetDirLock 
move.| dosbase,a6 


jsr -90(a6) ; UnLock () 
movem.| (sp)+ ‚a0-al 
bra GetDir Start 

GetDir Ende: 


move.b #":",-(a3) 
move.|l a0,-(sp) 
move.|  GetDirLock,d1 
move.l dosbase,a6 
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jsr -90(a6) ; UnLock () 
move.l (sp)+,dO 

movegq #0,d1 

move.|l d1,GetDirLock 

lea DirNamePufferEnd,a0 


cmp.b #"/",-1(a0) 
bne GetDir End 
move.b #0,-1(a0) 
GetDir End: 
rts 
GetDir Error: 
move.|l  GetDirLock,d1 
beq GetDir_Error2 
move.l dosbase,a6 


jsr -90(a6) ; Unlock () 
GetDir_Error2: 

moveq #0,d0 

move.|l dO,GetDirLock 


rts 


GetDirLock: de. O 
FreeName: dc.w 0 

cnop 0,4 
GetDirInfoBGetDirLock: bik.b 260,0 


DirNamePuffer: bik.b 1000,0 
DirNamePufferEnd: dc.w 0 


‘ 


ee 


;--- Ein DOS-File auf Disk speichern -_-. 
;--- (D0O,D2,A0,A1) (Laenge,Mode,Name, Puffer) -.. 
;=--- Mode: 0 = Normal, 1 = fortlaufend weiterspeichern --- 
;--- 2 = Motor ausschalten -..- 
;--- => DO = Anzahl Bytes „ oder 0 = Error --- 
SaveFile: 

move.|l #1006,FileModus 

move.| dO,Filelaenge 

move.|l a0,Filename 

move.| al,FilePuffer 

cmp.w #0,d2 

beq SaveFile Normal 
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cmp.w #1,d2 
beq SaveFile Continue 
cmp.w #2,d2 


beq SaveFile Ende 
SaveFile Error: 

moveq #0,d0 

rts 


;- Ab hier File wieder schließen --- 
SaveFile_Ende: 
move.| filehd,d1 


beq SaveFile Error 
bsr CloseFile 
rts 


;-- Ab hier File weiter Speichern --- 
SaveFile Continue: 

move.l FileHd,d1 

bne SaveFile C2 


bsr Openfile 
move.| dO,FileHd 
beq SaveFile Error 
SaveFile C2: 
bsr WriteFile 
cmp.l  Filelaenge,dO 
bne SaveFile C3 
rts 
SaveFile C3: 
move.|l dO,-(sp) 
bsr CloseFile 
move.| (sp)+,dO 
rts 


;—- Ab hier File normal Speichern --- 
SaveFile Normal: 


bsr Openfile 
move.|l dO,FileHd 
beq SaveFile Error 
bsr \WVriteFile 
move.l dO,-(sp) 

bsr CloseFile 
move.l (sp)+,dO 

rts 
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;--- Ein DOS-File von Disk laden --- 


;--- Mode: 0 = Normal, 1 = 


‚Mode ‚Name, Puffer) ee 
Motor bleibt an und selbe Disk --- 


;--- muß im Laufwerk bleiben, 2 = Motor ausschalten --- 


;--- (D0,D2,A0,A1) (Laenge 


;--- => DO = Anzahl Bytes 
LoadfFile: 
move.| #1005,FileModus 
move.| dO,Filelaenge 
move.l a0,Filename 
move.|l al,FilePuffer 


cmp.w #0,d2 

beq LoadFile Normal 
cmp.w #1,d2 

beq LoadFile_Continue 
cmp.w #2,d2 


beq LoadFile Ende 
LoadFile Error: 

moveq #0,d0 

rts 


;—- Ab hier File wieder schließen --- 
LoadFile Ende: 

move.| filehd,d1 

beq LoadFile_Error 

bsr CloseFile 

rts 


;- Ab hier File weiter laden -- 
LoadFile Continue: 
move.|l FileHd,d1 
bne LoadFile C2 
bsr Openfile 
move.|l dO,FileHd 
beq LoadFile Error 
LoadFile_C2: 
bsr ReadfFile 
cmp.| Filelaenge,dO 
bne LoadFile_C3 


rts 
LoadFile_C3: 
move.| dO,-(sp) 


bsr CloseFile 
move.l (sp)+,dO 
rts 


‚oder 0 = Error --.- 
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;— Ab hier File normal laden --- 
LoadFile Normal: 


bsr Openfile 
move.l dO,FileHd 
beq LoadFile Error 
bsr ReadfFile 
move.l dO,-(sp) 
bsr CloseFile 
move.l (sp)+,dO 
rts 
Openfile: 
move.l  FileModus,d2 
move.|l filename,di ; Filename 
move.l dosbase,a6 
jsr -30(a6) ; Open () 
rts 
ReadFile: 


move.l filehd,d1 
move.l filepuffer,d2 
move.l filelaenge,d3 
move.l dosbase,a6 
jsr -42(a6) ;‚ Read () 
rts 
WriteFile: 
move.| filehd,d1 
move.l filepuffer,d2 
move.l filelaenge,d3 
move.l dosbase,a6 
jsr -48(a6) ; Write () 
rts 
CloseFile: 
move.l filehd,d1 
move.|l dosbase,a6 


jsr -36(a6) ; Close () 
moveq #0,d0 
move.l dO,filehd 
rts 
FileModus: de.l 0 
FileHd: dc.! O 
Filelaenge:. dc.l 0 
Filename: dc.| O 
FilePuffer: dc.l O0 
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;--- Gucken ob File auf Disk und wie lang -.-- 
;--- (A0) (Filename) --- 
j--- => DO = 0, dann Error; sonst Filelänge --- 
LookfFile: 
move.| dosbase,a6 
move.l a0,d1 
moveq #-2,d2 
jsr -84(a6) ; Lock () 
move.l dO,lock 
beq LookFile_ Error 
move.|l dosbase,a6 
move.| dO,di 
move.l  #fileinfo,d2 
jsr -102(a6) ; Examine () 
tst.| do 
beq LookFile_Error 
lea Filelnfo,a0 
move.l 124(a0),dO 
LookFile_Error: 
move.l dO,-(sp) 
move.l Lock,d1 
beq LookFile End 
move.l dosbase,a6 
jsr -90(a6) ; UnLock 
LookFile_End: 
move.l (sp)+,do 
rts 
Lock: 
dc.I 0 
CNop 0,4 
Filelnfo: 
bik.b 260,0 
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8. Die ASL-Library 


Seit den Amiga-Style-Guides sollten alle Programmoberflächen einen 
einheitlichen Look haben. Daraus entstand unter anderem die ASL- 
Library. Sie ist für die Verwaltung von File-, Font- oder ScreenMode- 
Requestern verantwortlich. Ein Requester ist ein Fenster über das 
bestimmte Daten angewählt werden und über Ok oder Cancel das 
Ergebnis liefert. Gerade bei der Verzeichnisdarstellung, hatte damals 
jedes Programm seine eigene Oberfläche und man mußte sich immer 
wieder umstellen. 


Mit der ASL-Library ist die Programmierung von Auswahl-Requestern 
ein Kinderspiel geworden. Voraussetzung ist aber mindestens 052.0. 


8.1 Die ASL-Routinen 


Es werden bisher (bis 053.1) drei Arten von Requestern unterstützt, 
in Abhängigkeit der Versionsnummer. 


=> File-Requester (Datenauswahl über Verzeichnis) 
=> Font-Requester (Zeichensatzauswahl) 
=> ScreenMode-Requester (Bildschirmmodusauswahl) 


Verwaltet (Programmiert) werden die Requester über sechs ASL-Funk- 
tionen: 


- AllocAslRequest (beliebiges Requester anlegen) 
- AslRequest (beliebiges Requester anzeigen und auf Auswahl warten) 
- FreeAslRequest (beliebiges Requester freigeben) 


- AllocFileRequest (File-Requester anlegen) 


- Requestfile (File-Requester anzeigen und auf Auswahl warten) 
- FreeFileRequest (File-Requester freigeben) 
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Die Programmierung der einzelnen Funktionen ist leicht zu verstehen. 
Als erstes müssen Sie natürlich die "asl.library" öffnen. Danach legen 
Sie alle notwendigen Parameter für das gewünschte Requester mit 
der Funktion "AllocAslRequest ()" an, lassen diese mit Hilfe von 
"AslRequest ()" anzeigen und erwarten die Auswahl des Benutzers. 
Das Ergebnis wird entsprechend dem Programm bearbeitet und das 
Requester mit "FreeAslRequest ()" wieder freigegeben. 


Eine ausführliche Beschreibung der einzelnen Funktionen können wir 
uns, auf Grund der einfachen Programmierung, sparen. Es folgt eine 
Kurzbeschreibung jeder Routine. 


Routine: AllocAslRequest (ReqType,TagList) (DO,AO) 

Offset: -48 (ab V36) 

Parameter: DO = Requesterart, die geöffnet werden soll (s. unten) 

AO = Tagliste, die das Aussehen des Requesters be- 

stimmen oder Null (s. unten) 

Rückgabe: =>DO = eine initialisierte Requester-Struktur. Der Auf- 
bau ist Abhängig vom ReqType (s. unten) oder 
Null, wenn Requester nicht verfügbar (Fehler). 

Erklärung: 

Diese Funktion erzeugt eine Requester-Struktur für den angegeben 

Typ. Bisher stehen einem drei Requesterarten zur Auswahl; File-, 

Font- oder ScreenMode-Requester. Eine Tagliste ist eine Tabelle mit 

Parametern, die das Requester genauer beschreiben. Übergibt man in 

AO eine Null, werden Standard-Werte ausgewählt. Sie sollten am 

besten immer einen Null-Zeiger verwenden (AO=0), da Sie die 

Tagliste auch unmittelbar vor dem Anzeigen, mittels "AslRequest ()", 

verwenden können. 
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Routine: AslRequest (Requester,TagList) (AO,A1) 
Offset: -60 (ab V36) 
Parameter: AD = Adresse einer initialisierten Requester-Struktur 
(erhalten wir über AllocAslRequest) 
Al = Tagliste, die das Aussehen des Requesters be- 
stimmen oder Null (s. unten) 
False (Null), wenn Fehler aufgetreten o. Cancel 
True (-1), wenn alles OK 


Rückgabe: =>DO 


Erklärung: 
Mit AslRequest () wird der Requester angezeigt und das Programm 


muß solange warten, bis der Benutzer eine Auswahl getroffen hat. Ist . 
das Ergebnis True, können alle gewünschten Auswahlwerte der 
Requester-Struktur entnommen werden. Die Werte sind abhängig von 
den Tags in der Tagliste. Ist das Ergebnis False, hat der Benutzer 
entweder den Cancel-Button oder das Schließgadget gedrückt oder es 
ist ein anderer Fehler aufgetreten. Seit der Version V38 kann über 
die DOS-Funktion "IOErr ()" die genaue Fehlernummer ermittelt 
werden. Bei einer Null wurde der Cancel-Button bzw. das Schließ- 
gadget betätigt. 


Routine: FreeAslRequest (Requester) (AO) 

Offset: -54 (ab V36) 

Parameter: AD = Adresse einer initialisierten Requester-Struktur 
(erhalten wir über AllocAslRequest) 

Rückgabe: keine 

Erklärung: 

Mit FreeAslRequest () wird der Speicher für die angelegte Request- 

Struktur wieder dem System zurückgegeben. 


———.——._—_.:__ 
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Routine: AllocFileRequest () 

Offset: -30 (ab V36) 

Paramter: keine 

Rückgabe: =>DO = Adresse einer FileRequest-Struktur oder Null 
für Fehler. 

Erklärung: 

Mit dieser Funktion wird ein File-Requester vom System angelegt. Auf 

den Aufbau hat man keinen Einfluß. Sie sollten deshalb lieber die 

Funktion "AllocAslRequest ()" verwenden. 


Routine: RequestFile (FileRequester) (AO) 

Offset: -42 (ab V36) 

Parameter: AD = Adresse einer FileRequest-Struktur, die wir durch 
AllocFileRequest () erhalten haben 

Rückgabe: =>DO = siehe AslRequest () 

Erklärung: 

Mit RequestFile () wird ein FileRequester angezeigt und auf die Aus- 

wahl vom Benutzer gewartet. Das Ergebnis entspricht dem von Asl- 

Request (). 


Routine: FreeFileRequest (Requester) (AO) 

Offset: -36 (ab V36) 

Parameter: AD = Adresse einer initialisierten Requester-Struktur 
(erhalten wir über AllocAslRequest) 

Rückgabe: keine 

Erklärung: 

Mit FreeFileRequest () wird der Speicher für die angelegte File- 

Request-Struktur wieder dem System zurückgegeben. 
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ögliche R ter-Typen für AllocAsiR DO 
7 ame W Funktion 
ASL_FileRequest 0 File-Requester anlegen (ab V36) 
ASL FontRequest 1 Font-Requester anlegen (ab V36) 


ASL ScreenModeRequest 2 ScreenMode-Requester anlegen (ab V38) 


In Abhängigkeit des Typs, wird eine Request-Struktur durch AllocAsl- 
Request () angelegt. Wie diese im Einzelnen aussehen und welche 
Tags erlaubt sind, darauf gehen wir jetzt ein. 


Aufbau _der FileRequester-Struktur (56 Bytes) 


Offset Name Funktion 

00 fr _pad ungenutzte 4 Bytes 

04 fr File Zeiger auf Inhalt des File-Gadget (ASCII-Puffer) 

08 fr_Drawer Zeiger auf Inhalt des Drawer-Gadget (ASCII-Puffer) 

12  fr_Reserved1,10 reserviert (10 Bytes) 

22 fr _LeftEdge Position der linken oberen Ecke (X) des Requester-Fenster 
24 fr _TopEdge Position der linken oberen Ecke (Y) des Requester-Fenster 
26 fr_Width Breite des Requester-Fenster 

28 fr _Height Höhe des Requester-Fenster 

30 fr _Reserved2,2 reserviert (2 Bytes) 

32  fr_NumArgs Anzahl der selektierten Files 

36 fr _Arglist Adresse der Liste mit den selektierten Files 

40 fr _UserData Zeiger auf User-Daten 

44 fr _Reserved3,8 reserviert (8 Bytes) 

52  fr_Pattern Zeiger auf Inhalt des Pattern-Gadget (ASCII-Puffer) 

56 Ende 


Mögliche Tags für ein FileRequester 


T. F 

; Tags für Fensterbeeinflußung -- 

ASLFR_ Window ASL_ TB+2 eigene Window-Adresse setzen (V36) 
ASLFR_S$creen ASL_TB+40 eigene Screen-Adresse setzen (V38) 
ASLFR_PubScreenName ASL_TB+41 eigenen Namen für PublicScreen (V38) 
ASLFR PrivatelDCMP ASL_TB+42 bei True neuen IDCMP-Port anlegen (V38) 
ASLFR IntuiMsgFunce ASL_TB+70 eigen Funktion für Messages (V38) 

ASLFR SleepWindow ASL_TB+43 bei True, Fenster inaktiv schalten (V38) 
ASLFR_UserData ASL TB+52 Adresse von fr_UserData setzen (V38) 
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;— Tags für die Textanzeige -- 


ASLFR_TextAttr ASL TB+51 Zeiger auf TextAttr-Struktur 0. Null (V38) 
ASLFR _Locale ASL_TB+50 Zeiger auf Locale-Struktur o. Null (V38) 
AHSLFR _TitleText ASL TB+1 Adresse vom Windownamen (V38) 
ASLFR_PositiveText ASL_TB+18 Textadresse für OK-Gadget (V36) 
ASLFR_NegativeText ASL_TB+19 Textadresse für Cancel-Gadget (V36) 

;-— Grundparameter für FileRequester --- 

ASLFR_InitialleftEedge ASL_TB+3 X-Pos. vom Requester (V36) 

ASLFR InitialTopEdge ASL_TB+4 Y-Pos. vom Requester (V36) 
ASLFR_InitialWidth ASL_TB+5 Breite vom Requester (V36) 
ASLFR_InitialHeight ASL_TB+6 Höhe vom Requester (V36) 
ASLFR_InitialFile ASL_TB+8 Adresse vom Filenameinhalt (V36) 
ASLFR_InitialDrawer ASL_TB+9 Adresse vom Drawernameinhalt (V36) 
ASLFR_InitialPattern ASL_TB+ 10 Adresse vom Patterninhalt (V36) 

;— zusätzliche Funktionen für FileRequester -- 

ASLFR_Flags1 ASL_TB+20 Flags für spezielle Funktionen (V36) 
ASLFR_Flags2 ASL_ TB+22 Flags für spezielle Funktionen (V36) 
ASLFR DoSaveMode ASL_TB+44 True = Save-Requester, sonst False (V38) 
ASLFR_DoMultiSelect ASL_TB+45 True = mehrfache Auswahl (V38) 
ASLFR_DoPäatterns ASL_TB+46 True = Pattern-Gadget aktiv (V38) 

;-- Funktionen zum Filtern (Maskieren) für FileRequester --- 

ASLFR_DrawersOnly ASL_TB+47 True = nur Drawer-Gadget (V38) 
ASLFR_FilterFunc ASL_TB+49 Hook-Adresse für Filterfunktion (V38) 
ASLFR_Rejectlcons ASL_TB+60 True = .info-Dateien nicht anzeigen (V38) 
ASLFR_RejectPattern ASL_TB+61 ausgeschlossene Patterns (V38) 
ASLFR_AcceptPattern ASL_TB+62 erlaubte Patterns (V38) 
ASLFR_FilterDrawers ASL_TB+63 True=Pattern auch für Drawer (V38) 
ASLFR_HookFunc ASL_TB+7 Funktion für bestimmte Flags (V38) 


liche Bits für R_Flags1-T 


Bit F 
FR,DOWILDFUNC 7  Hook-Funktion für FileRequester zulassen 
FR,DOMSGFUNC 6 eigenen Hook-MessagePort zulassen 
FR,DOSAVEMODE 5 FileRequester im Save-Modus betreiben 
FR,PRIVATEIDCMP 4 eigenen IDCMP-Port zulassen 
FR,DOMULTISELECT 3 FileRequester im MultiSelect-Modus betreiben 
FR,DOPATTERNS 0 Pattern-Gadget zulassen 


li Bits für RF -T 
“t Funkti 
FR,DRAWERSONLY O0 nur Drawer (Direktories) anzeigen 


FR,FILTERDRAWERS 1 nur Files zulassen 
FR,REJECTICONS 2  .info-Dateien nicht anzeigen 
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Aufbau der FontRequester-Struktur (44 Bytes) 


Na F 

00 fo pad ungenutzte 8 Bytes 

08 fo Atıtr ab hier liegt eine Attr-Struktur (8 Bytes) 

16  fo_FrontPen Farbregister für Textfarbe 

17 fo BackPen Farbregister für Hintergrundfarbe 

18 fo DrawMode Zeichenmodus (Normal,Fett,Schräg,Unterstrichen,Invers) 
19 fo Reserved reserviert (1 Byte) 

20 fo _UserData Zeiger auf User-Daten 

24 fo LeftEdge Position der linken oberen Ecke (X) des Requester-Fenster 
26 fo TopEdge Position der linken oberen Ecke (Y) des Requester-Fenster 
28 fo _Width Breite des Requester-Fenster 

30 fo _Height Höhe des Requester-Fenster 

32 fo TAttr ab hier liegt eine TAttr-Struktur (12 Bytes) 

44 Ende 

Mögliche Tags für ein FontRequester 

T: me Wert Funktion 


;—- Tags für Fensterbeeinflußung —- 
ASLFO Window ASL TB+2 
ASLFO_ Screen ASL_TB+40 
ASLFO PubScreenName ASL _TB+41 


ASLFO PrivatelDCMP ASL_TB+42 
ASLFO_IntuiMsgFunc ASL_TB+70 
ASLFO SleepWindow ASL_TB+43 
ASLFO _UserData ASL_ TB+52 


;—- Tags für die Textanzeige --- 


ASLFO TextAttr ASL TB+51 
ASLFO Locale ASL_TB+50 
ASLFO TitleText ASL TB+1 

ASLFO PositiveText ASL TB+18 
ASLFO_NegativeText ASL_TB+19 


;- Grundparameter für FileRequester --- 


ASLFO InitialleftEdge ASL_TB+3 
ASLFO InitialTopEdge ASL_TB+4 
ASLFO InitialWidth ASL_TB+5 
ASLFO InitialHeight ASL TB+6 
ASLFO InitialName ASL TB+ 10 
ASLFO_InitialSize ASL TB+11 
ASLFO InitialStyle ASL_ TB+12 
ASLFO InitialFlags ASL TB+13 
ASLFO_InitialFfrontPen ASL TB+14 
ASLFO InitialBackPen ASL_TB+15 


ASLFO InitialDrawMode ASL_TB+59 


eigene Window-Adresse setzen (V36) 
eigene Screen-Adresse setzen (V38) 
eigenen Namen für PublicScreen (V38) 
bei True neuen IDCMP-Port anlegen (V38) 
eigen Funktion für Messages (V38) 

bei True, Fenster inaktiv schalten (V38) 
Adresse von fr _UserData setzen (V38) 


Zeiger auf TextAttr-Struktur o. Null (V38) 
Zeiger auf Locale-Struktur o. Null (V38) 
Adresse vom Windownamen (V38) 
Textadresse für OK-Gadget (V36) 
Textadresse für Cancel-Gadget (V36) 


X-Pos. vom Requester (V36) 

Y-Pos. vom Requester (V36) 

Breite vom Requester (V36) 

Höhe vom Requester (V36) 

Adresse des Fontnameninhalts (V36) 
Wert für Fonthöhe-Gadget (V36) 
Wert für FontStyle-Gadget (V36) 
Flags für bestimmte Funktionen (V36) 
Wert für FrontPen (V36) 

Wert für BackPen (V36) 

Wert für DrawMode (V36) 
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-- Grundparameter für FontRequester -- 


ASLFO _Flags ASL_TB+20 Flags für bestimmte Funktionen (V36) 
ASLFO_DofrontPen ASL_ TB+44 True=FrontPen-Gadget aktiv (V38) 
ASLFO DoBackPen ASL_TB+45 True=BackPen-Gadget aktiv (V38) 
ASLFO _DoStyle ASL_ TB+46 True =FontStyle-Gadget aktiv (V38) 
ASLFO_ DoDrawMode ASL_TB+47 True = DrawMode-Gadget aktiv (V38) 

-- Funktionen zum Filtern (Maskieren) für FontRequester —- 
ASLFO _FixedWidthOnly ASL_TB+48 True=nur FixedWidth-Fonts zeigen (V38) 
ASLFO_MinHeight ASL_TB+16 Minimale zugelassene Fonthöhe (V36) 
ASLFO MaxHeight ASL_TB+17 Maximal zugelassene Fonthöhe (V36) 
ASLFO _FilterFunc ASL_TB+49 siehe FileRequester 
ASLFO _HookFunc ASL_ TB+7 siehe FileRequester 
ASLFO Maxfrontfen ASL_TB+66 Max. Anzahl Farben für FP-Auswahl (V40) 
ASLFO MaxBackPen ASL_TB+67 Max. Anzahl Farben für BP-Auswahl (V40) 
;-- weitere Funktionen für FontRequester ---- 
ASLFO Modelist ASL_TB+21 Zeiger auf ein Array mit eigenen Namen 

für DrawMode-Texte. (V36) 

ASLFO_FrontColors ASL_TB+64 Zeiger auf ein Array, welches die Farb- 


registernummern für FrontPen-Farb- 
Auswahl enthält (Bytes) = >V40 
ASLFO BackColors ASL_TB+65 wie oben, aber für BackPen 


liche Bits für ASLFO_FI 


FO,DOFRONTPEN 0 FrontPen-Gadget zulassen 
FO,DOBACKPEN 1  BackPen-Gadget zulassen 
FO,DOFONTSTYLE 2  FontStyle-Gadget zulassen 
FO,DODRAWMODE 3  DrawMode-Gadget zulassen 
FO,FIXEDWIDTHONLY 4 nur FixedWidth-Fonts zulassen 
FO,PRIVATE 5 privat 
FO,DOMSGFUNC 6 siehe FileRequester 
FO,DOWILDFUNC 7 siehe FileRequester 

r n -5 r_ (4 

F 


00 sm_DisplaylD Wert der Display-Mode-ID für Screen 

04 sm _DisplayWidth Breite des Screens 

08 sm_DisplayHeight Höhe des Screens 

12 sm_DisplayDepth Anzahl der Bitplanes für Screen 

14 sm,„OverscanType Screen-Overscan-Typ 

16 sm _Auto$croll Automatisches Scrollen bei Übergröße aktiv ? 
18 sm _BitMapWidth Breite der Bitmap 
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22 sm _BitMapHeight Höhe der Bitmap 

Position der linken oberen Ecke (X) des Requester-Fenster 
Position der linken oberen Ecke (Y) des Requester-Fenster 
Breite des Requester-Fenster 

Höhe des Requester-Fenster 

Informationswindow auch öffnen ? 

X-Position vom Info-Fenster 

Y-Position vom Info-Fenster 

Breite des Info-Fensters 

Höhe des Info-Fensters 

Adresse des eigenen Datenpuffers oder Null 


26 sm _LeftEdge 
28 sm _TopEdge 
30 sm _Width 

32 sm Height 

34 sm _InfoOpened 
36 sm _InfoLeftEdge 
38 sm_InfoTopEdge 
40 sm_InfoWidth 
42 sm _InfoHeight 
44 sm UserData 


Mögliche Tags für ein ScreenModeRequester 


Tag-Name Wert Funktion 


;-- Tags für Fensterbeeinflußung -—- 
ASLSM Window ASL_TB+2 
ASLSM Screen ASL TB+40 
ASLSM PubScreenName ASL TB+41 


ASLSM_PrivatelDCMP ASL_TB+42 
ASLSM IntuiMsgFunc ASL_TB+70 
ASLSM SleepWindow ASL TB+43 
ASLSM _UserData ASL TB+52 


-- Tags für die Textanzeige --- 


ASLSM TextAttr ASL TB+51 
ASLSM Locale ASL TB+50 
ASLSM TitleText ASL TB+1 

ASLSM PositiveText ASL_TB+ 18 
ASLSM NegativeText ASL_TB+ 19 


;--- Grundparameter für FileRequester --- 
ASLSM InitialleftEedge ASL_TB+3 
ASLSM InitialTopEdge ASL TB+4 
ASLSM _InitialWidth ASL_ TB+5 
ASLSM InitialHeight ASL_TB+6 
ASLSM InitialDisplaylD ASL_TB+ 100 
ASLSM InitialDisplayWidth ASL_TB+ 101 
ASLSM InitialDisplayHeight ASL_TB+ 102 
ASLSM InitialDisplayDepth ASL_TB+103 
ASLSM InitialOverscanType ASL_TB+ 104 
ASLSM InitialAutoScroll ASL_TB+ 105 
ASLSM InitiallnfoOpened ASL_TB+ 106 
ASLSM InitiallnfoLeftEdge ASL_TB+ 107 
ASLSM _InitiallnfoTopEdge ASL_TB+ 108 


eigene Window-Adresse setzen (V36) 
eigene Screen-Adresse setzen (V38) 
eigenen Namen für Public$creen (V38) 
bei True neuen IDCMP-Port anlegen (V38) 
eigen Funktion für Messages (V38) 

bei True, Fenster inaktiv schalten (V38) 
Adresse von fr_UserData setzen (V38) 


Zeiger auf TextAttr-Struktur o. Null (V38) 
Zeiger auf Locale-Struktur o. Null (V38) 
Adresse vom Windownamen (V38) 
Textadresse für OK-Gadget (V36) 
Textadresse für Cancel-Gadget (V36) 


X-Pos. vom Requester (V38) 

Y-Pos. vom Requester (V38) 

Breite vom Requester (V38) 

Höhe vom Requester (V38) 

Wert für DisplayID-Gadget (V38) 
Wert für Screenbreiten-Gadget (V38) 
Wert für Screenhöhen-Gadget (V38) 
Wert für Farbanzahl-Gadget (V38) 
Wert für OverscanType-Gadget (V38) 
True=Auto$Scroll aktiv (V38) 
True=Info-Fenster aktiv (V38) 
X-Position für Info-Fenster (V38) 
Y-Position für Info-Fenster (V38) 


- Grundparameter für ScreenModeRequester --- 


ASLSM DoWidth ASL TB+ 109 
ASLSM DoHeight ASL TB+110 
ASLSM_DoDepth ASL TB+111 


True = Screenbreiten-Gadget aktiv (V38) 
True =Screenhöhen-Gadget aktiv (V38) 
True=Screentiefen-Gadget aktiv (V38) 
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ASLSM_DoOverscanType ASL_TB+112 True = OverscanType-Gadget aktiv (V38) 
ASLSM DoAutoScroll ASL_TB+113 True = AutoScroll-Gadget aktiv (V38) 

--- Funktionen zum Filtern (Maskieren) für ScreenModeRequester --- 
ASLSM_PropertyFlags ASL_TB+114 Wert für PropertyFlags setzen (V38) 
ASLSM PropertyMask ASL_TB+115 Wert für PropertyMask setzen (V38) 


ASLSM MinWidth ASL_ TB+116 Minimale Screenbreite setzen (V38) 
ASLSM_MaxWidth ASL_TB+117 Maximale Screenbreite setzen (V38) 
ASLSM _MinHeight ASL_TB+118 Minimale Screenhöhe setzen (V38) 
ASLSM_MaxHeight ASL_TB+119 Maximale Screenhöhe setzen (V38) 
ASLSM MinDepth ASL_TB+ 120 Minimale Screentiefe setzen (V38) 
ASLSM MaxDepth ASL TB+121 Maximale Screentiefe setzen (V38) 
ASLSM _FilterFunc ASL_ TB+122 Hook-Struktur für Filterfunktion 


;— weitere Funktionen für ScreenModeRequester --- 
ASLSM CustomSMList ASL_TB+123 Zeiger auf eigene DisplayMode-Struktur 


Es gibt auch noch die alten Bezeichnungen. Aus Kompatibilitäts- 
gründen, führen wir sie hier auf. Sie sollten für die Zukunft die 


aktuellen Bezeichnungen verwenden (ab Includes 3.0). 






ASL_Hail ASL- TB+1 (TitleText) 
ASL_Window ASL_TB+2 (Window) 
ASL_LeftEdge ASL_TB+3 (LeftEdge) 
ASL_TopEdge ASL_TB+4 (TopEdge) 
ASL_Width ASL_ TB+5 (Width) 
ASL_Height ASL_TB+6 (Height) 
ASL_HookFunc ASL_ TB+7 (HookFunc) 
ASL_File ASL_TB+8 (InitialFile) 
ASL_Dir ASL_TB+9 (InitialDrawer) 
ASL_Pattern ASL_TB+ 10 (InitialPattern) 
ASL_FontName ASL_TB+ 10 (InitialName) 
ASL_FontHeight ASL TB+11 (InitialSize) 
ASL_FontStyles ASL_TB+12 (InitialStyle) 
ASL_FontFlags ASL_TB+13 (InitialFlags) 
ASL_FrontPen ASL_TB+ 14 (InitialFrontPen) 
ASL_BackPen ASL_TB+15 (InitialBackPen) 
ASL_MinHeight ASL_TB+16 (MinHeight) 
ASL_MaxHeight ASL_TB+17 (MaxHeight) 
ASL_OKText ASL_TB+ 18 (PositiveText) 
ASL_CancelText ASL_TB+19 (NegativeText) 
ASL_FuncFlags ASL_ TB+20 (Flags1) 
ASL_Modelist ASL TB+21 (Modelist) 
ASL_ExtFlags! ASL_TB+22 (Flags2) 
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Die Basisadresse "ASL_TB" lautet: $80080000 


Sie sollten aber lieber die jeweiligen Includes einbinden, so daß Sie 
die originalen Bezeichnungen einsetzen können. 


Es müssen nicht immer alle Tags übergeben werden. Jeder fehlende 
Parameter wird durch Standard-Werte ersetzt. Wichtig ist auch, daß 
die Requester-Strukturen nur ausgelesen werden. Schreiben Sie auf 
keinen Fall direkt Werte hinein. 


8.2 Beispiel: Direktory anzeigen 


Zum Abschluß noch ein Beispiel für ein FileRequester. Sie können es 
leicht in Ihr eigenes Programm einbinden. Um Probleme mit dem 
richtigen Pfadnamen zu vermeiden, sollten Sie das Listing mit dem 
Beispiel aus Kapitel 7.7 (aktuellen Pfad ermitteln) verbinden. 


u. |. | m nn nn nn = | |; = —.—— |. .— |. nn |. nn... m oo =... 


Include "libraries/asl.i" ; richtigen Pfad angeben - Wichtig ! 
move.l 4,36 

lea AslLibName,al 

moveq #0,d0 

jsr -552(a6) ; OpenLibrary () 

move.l dO,aslbase 

beq Ende 


move.l #ASL_FileRequest,dO ; Type = FileRequester 
lea FileTagList,aO ; TagListe für Aufbau 
move.|l aslbase,a6 

jsr -48(a6) ; AllocAslRequest () 
move.| dO,FileRequest ; Adresse retten 

beq Ende ; bei Fehler => Ende 
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;--- Verzeichnis anzeigen und bearbeiten --- 

lea NewTitle,aO 

bsr Dir 

move.|l dO,DirErgebnis ; Wert retten für Prg.Ende 
i--- FileRequester entfernen --- 


move.l FileRequest,aO 
move.|l aslbase,a6 


jsr -54(a6) ; FreeAslRequest () 
Ende: 

move.l aslbase,dO 

beq Ende _1 


move.|l dO,al 
move.| 4,36 


jsr -414(a6) ; CloseLibrary () 
Ende _1 
move.|l DirErgebnis,dO ; Ergebnis des FileRequest 
rts ; Programmende 
;--- Directory laden --- 
;--- (AO) (Überschrift --- 
;--- => DO = Filename, 0 = Cancel, -1 = Error --- 
Dir: 
lea FileuseTaglist,a1 ; Tagliste für TitelText 
move.| a0,4(a1) ; TitelText eintragen 


move.l  FileRequest,aO 
move.|l aslbase,a6 


jsr -60(a6) ; AslRequest () 

tst.| dO ; Cancel ? 

bne Dir_Go 

rts ; wenn ja, dann Ende 
Dir_go: 

cmp.| #-1,d0 ; Error ? 


beq Dir_Error 


move.|l FileRequest,a6 


move.l 4(a6),a0 ; A0D=Filename (fr_File) 
move.|l 8(a6),a1 ; Al=DirName (fr_Drawer) 
tst.b (a0) ; Filename vorhanden ? 
beq Dir_Error ; wenn nicht, dann Error 
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lea FileNamePuffer ‚a2 
move.l| a0,dO 


;- ab hier DrawerName testen --- 


Dir_TestDrawerName: 
tst.b (a1) 
beq Dir_CopyFileName 
cmp.b  #"/",(al) 


bne Dir_CopyDrawerName 
addqa.w #1,al 
bra Dir_TestDrawerName 


er ab hier DrawerName kopieren --- 


Dir CopyDrawerName: 
move.l| a2,d0 


Dir CDN]: 
move.b (al)+ (a2)+ 
tst.b (al) 
bne Dir _CDNI 


cmp.b #":",-1(al) 
beq Dir_CopyFileName 
cmp.b #"/",-1(a1) 
beq Dir_CopyFileName 
move.b #"/",(a2)+ 


’ 


;-- ab hier Filename kopieren und testen --- 


Dir_CopyFileName: 
move.b (a0)+ ‚(a2)+ 
cmp.b  #"/",(a0) 
beq Dir_Error 


tst.b (a0) 
bne Dir_CopyFileName 
cir.b (a2) 
Dir _Ok: 
rts 
Dir _Error: 
moveq #-1,d0 
rts 
;i--- Parameter --- 


We 


NewrTitle: dc.b "Bitte wählen Sie:",O 
even 
DirErgebnis: dc.| O 


; Puffer für kompletten Pfad 
; Filename nach DO 


; Ende von DrawerName ? 

wenn nicht, dann Filename kopieren 
bei "/" auch Filename kopieren 
sonst DrawerName kopieren 
nächstes Drawer-Zeichen 


eo u. 


ne 


; Filenamepuffer nach DO 


‚ ein Zeichen kopieren 

Ende von DrawerName ? 
wenn nicht, dann Dir _CDNI 
‚ war letztes Zeichen ein ":" ? 
dann Filename kopieren 
war letztes Zeichen ein "/" ? 
dann Filename kopieren 

; sonst "/" einfügen 


me |. me -. 


ein Zeichen kopieren 

nächstes Zeichen ein "/" ? 

dann Error 

; Ende von Filename ? 

; wenn nicht, dann weiter kopieren 
; Ende vom kompletten Pfad setzen 


mu... 


; Ergebnis des FileRequest 
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FileRequest: dc.| O ; Adresse der FileRequester-Struktur 
cnop 0,8 

FileTaglist: ; TagListe für FileRequester 

dc.| ASLFR_Window,O ; hier könnte eigenes Window stehen 


dc.| ASLFR_TitleText, Title 

dc.! ASLFR_InitialLeftEdge, 100 

dc.| ASLFR_InitialTopEdge,00 

dc.| ASLFR_InitialWidth, 320 

dc.| ASLFR_InitialHeight,256 

dc.| ASLFR_PositiveText,OKText 

dc.| ASLFR_NegativeText,CancelText 

dc.l ASLFR_InitialFile,Filename 

dc.| ASLFR_InitialPattern,PatternText 

dc.| ASLFR_Flags1,1 ; Bit0O=1 => Pattern-Gadget zulassen 
dc.| TAG_DONE ; Ende der Liste 


FileUseTagList: 

dc.| ASLFR_TitleText,Title 
dc.| TAG_DONE 
FileNamePuffer: bik.b 1000,0 


PatternText: dc.b *" (#?.info)",O 


even 
Filename: dc.b "Filename",O 
even 

Title: dc.b "Directory",O 
even 

OKText: dc.b "Use",O 

even 

CancelText: dc.b "Cancel",O 
even 

aslbase: dc.l O0 
AslLibName: dc.b "asl.library",O 
even 
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9. Der Co-Prozessor (Copper) 


Das der Amiga so leistungsfähig ist, liegt daran, daß der Haupt- 
prozessor nicht alle Aufgaben alleine bewerkstelligen muß. Unterstüzt 
wird der Amiga von drei Co-Prozessoren, die jeder einen Teilbereich 
übernehmen (Sound, Grafik etc.). Deswegen kommt ein Amiga auch 
mit geringerer Taktfrequenz als ein PC zu einer stärkeren Rechen- 
leistung (MIPS). 


Der wohl wichtigste Co-Prozessor ist der Copper. Er hat als einziger 
eigene Befehle, drei an der Zahl, und ist damit in der Lage ein 
eigenes Programm abzuarbeiten. Dabei richtet sich der Copper genau 
nach dem Bildschirmaufbau, sprich der Rasterstrahlposition. 


Da der Copper auf fast alle Register der Custom-Chips zugreifen und 
zu jeder Rasterstrahlposition ändern kann, wird er hauptsächlich zum 
Bildschirmaufbau eingesetzt. Erst durch den Copper ist der Amiga in 
der Lage, mehrere Screens in verschiedenen Auflösungen und Farben 
gleichzeitig darzustellen. Allerdings kann man mit dem Copper noch 
einige Tricks mehr machen, wie Spiegeln, Parallax-Scrolling usw. 


9.1 Die Copperliste 


Der Copper wird nicht wie ein normaler Prozessor programmiert. 
Seine Befehle bestehen jeweils aus zweimal 16-Bit-Werten, welche 
nacheinander in einer Liste stehen müssen. Die Anfangsadresse dieser 
Copperliste muß in zwei Cutstomregistern eingetragen werden und 
über ein weiteres wird diese gestartet. Dabei sollte man die 
Copperliste am Besten zu Beginn der vertikalen Austastlücke starten, 
da sonst ein ünschönes Flackern entsteht. 
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Anfangsadresse der Copperliste eintragen in: 


COP1LCx = $DFFO8O ; für Lo-Res 
COP2LCx = $DFFO84 ; zwei Copperlisten für Interlace 


Copperliste starten, durch schreiben eines beliebigen Wertes in: 
COPJMP1 =$DFF088 ; 1. Copperliste starten 
COPJMP2 = $DFFOBA ; 2. Copperliste starten 


Hier ein kleines Beispiellisting zum Aktivieren einer Copperliste: 


lea $dff000,a6 ; Chipbasis 
move.l #copperlist,$80(a6) ; Copperliste eintragen 
move.w #0,$dff080 ; Copperliste starten 


9.3 Die Copperbefehle 


jetzt kommen wir zu den Befehlen des Coppers. Er kennt die drei 
Befehle MOVE, WAIT und SKIP. Wobei der SKIP-Befehl eine 
untergeordnete Rolle spielt, da er so gut wie ganicht verwendet wird. 
Eine Copperliste besteht hauptsächlich aus MOVE- und WAIT- 
Instruktionen. 


Wenn zum Beispiel ab Rasterzeile 50 ein anderer Screen mit mehr 
Farben erscheinen soll, so wird mit dem WAIT-Befehl auf die 
gewünschte Zeile gewartet und mit einigen MOVE-Befehlen werden 
dann die entsprechenden Custom-Register mit den neuen \Werten 
gefüllt und der neue Screen erscheint. 
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Es folgt jetzt eine Beschreibung der einzelnen Befehle: 


Der MOVE-Befehl: 
Format:  Register,Wert 


Über den MOVE-Befehl kann man ein beliebiges Customregister mit 
einem Wert laden. Allerdings kann der Copper nicht auf alle Register 
zugreifen. Es stehen, bei einem normalen Amiga, nur die Register 
von 


$DFFO80 bis $DFFIBE 


zur Verfügung. Durch setzen des COPCON-Registers (PDFFOZE) auf 
den Wert 1 stehen einem auch die Register von 


$DFFO4O bis $DFFOTE 


zur Verfügung. Bei ECS-Amigas (600 und 500plus) und höher (AA- 
Amigas => 1200/4000) können gleich alle Register benutzt werden. 


Das erste Befehlsword (16 Bit Wert) besitzt die relative Custom- 
registeradresse (z. B. 0180 statt absolut $DFF180) und im zweiten 
Befehlsword den Wert, mit dem das Register geladen werden soll. 
Dabei ist zu beachten, daß das Bit Null im ersten Befehlsword immer 
Null ist, weil dieses das Erkennungszeichen des MOVE-Befehls ist. Da 
aber alle Register auf geraden Adressen liegen, ist dieses Bit 
automatisch immer Null und kann somit vernachlässigt werden. 


Beisprel:  dc.w $0182,$0000 ;‚cCOLORO1 = 0 


Bei dem Beispiel wird das Farbregister Eins mit dem Wert Null 
geladen (schwarz). 
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Der WAIT-Befehl: 
Format: Rasterzeile,Maske 


Der Wait-Befehl wartet auf eine bestimmte Rasterstrahlposition. Wird 
ein Wait-Befehl vom Copper gelesen, so vergleicht er die angegebene 
Position mit der tatsächlichen Rasterstrahlposition. Ist der Rasterstrahl 
schon weiter, so wird der nächste Befehl in der Copperliste gelesen. 
Andernfalls wird solange mit der Fortführung der Copperliste ge- 
wartet, bis die Rasterstrahlposition erreicht ist. 


Die Maske im zweiten Befehlsword gibt an, welches Positionsbit im 
ersten Befehlsword überhaupt zu einer Abfrage herangezogen werden 
kann. Nur wo im Maskenword das dazugehörige Bit gesetzt ist, wird 
eine Abfrage zugelassen. 


Es folgt eine Beschreibung der beiden Befehlswörter: 


fba n h 


15 14 ı3 12 11 10 09 08 07 06 05 04 03 02 01 00 
VP7 VP6 VP5 VP4 VP3 VP2 VP1 VPO HP8 HP7 HP6 HP5 HP4 HP3 HP2 001 


Aufbau _des zweiten Befehlswords: 


15 314 23 32 112 310 09 08 097 0% 05 04 95 92 Oi 00 
BFD VM6 VM5 VM4 VM3 VM2 VM1 VMO HM8 HM7 HM6 HM5 HM4 HM3 HM2 000 


VPx = vertikale Rasterstrahlposition (Y) 

HPx = horizontale Rasterstrahlposition (X) 

VMx = vertikale Maske 

HMx = horizontale Maske 

BFD = Blitter Finish Disable (0 = warten bis Blitter fertig) 


Beim WAIT-Befehl muß das Bit Null im ersten Befehlsword auf 1 und 
im zweiten auf O gesetzt werden, damit der Copper diesen als 
solchen identifizieren kann. 
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Bei einem PAL-Amiga gibt es 313 Rasterzeilen, jedoch können nur 
256 mögliche abgefragt werden (VP7 bis VPO). Möchte man die 
restlichen noch mit einbeziehen, so muß man erst auf die Zeile 255 
warten und danach auf die gewünschte, unter Vernachlässigung des 
9, Bits. Folgende Zeilen erfüllen diesen Zweck: 


Warten auf Zeilen größer 255: 


dc.w $ffO 1 ,$fff4 
dc.w $ffdf,$fffe 


Möchte man genau auf den Anfang eines Screens warten, so muß 
das obere Byte vom \Wert des Registers DIWSTRT ($DFFO8E) hinzu- 
addiert werden ($2b=43), denn der Rasterstrahl beginnt schon 
einige Zeilen früher (siehe Bild 9.a). 

Die horizontale Rasterstrahlposition läßt sich, auf Grund der sieben 
Bits (HP8 bis HP2), nur in vierer Schritten angeben, was 112 
mögliche Positionen zuläßt. 


Möchte man eine Copperliste beenden, so muß auf eine unmögliche 
Rasterstrahlposition gewartet werden. 


Beenden einer Copperliste: 


dc.w $ffff,$fffe ; unmögliche Position 
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Bild 9.a 








Aust astluecke 











eigentlicher 
AMIGA Screen 


Normal von 
Zeile 9 bis 25 







Der SKIP-Befehl: 
Format:  Rasterzeile,Maske 


Der SKIP-Befehl hat den selben Aufbau wie der WAIT-Befehl, nur das 
in beiden Befehlswörtern das Bit Null gleich Null ist. Liest der Copper 
diesen Befehl, so wird geprüft, ob die angegebene Rasterposition 
kleiner der tatsächlichen ist. Wenn das der Fall ist, so überspringt der 
Copper den nächsten Befehl, ansonsten fährt er in der Liste weiter. 
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9.4 Der Copperinterrupt 


Auch der Copper ist in der Lage einen Interrupt zu erzeugen. Als 
erstes müssen Sie den Copperinterrupt initialisieren (siehe Kapitel 
1.8). Ausgelöst wird der Interrupt dann durch Setzen des Copperinter- 
ruptbits im INTREQ-Register, durch einen MOVE- Befehl. 


Auslösen des Copperinterrupts durch einen MOVE-Befehl: 


dc.w $009C,$8010 ; IRQ auslösen 


9.5 Beispielcopperliste 


Als letztes folgt jetzt noch ein Beispiellisting, das eine eigene Copper- 
liste aktiviert. Damit wir später wieder auf die alte zurückschalten 
können, müssen wir vorher die Adressen der alten System-Copper- 
listen retten. Wie dieses programmiert wird, zeigt das kurze Listing. 


Das Beispiel funktioniert aber nur, wenn es von einem Lo-/HiRes 
Screen gestartet wird. Bei anderen Screens, sollte nach dem Beispiel 
aus Kapitel 14.2 auf die neue/alte Copperliste geschaltet werden. 


;-- erzeugt eine Copperliste über die Hardware --- 
-- und schaltet danach wieder auf die alte um --- 


lea gfxname,al ; graphics.library 

moveq #0,d0 ; Version 

move.|l 4,36 ‚ execbase 

jsr -552(a6) ; OpenLibrary () 

move.|l dO,gfxbase ; graphicsbase 

lea $dff000,a6 ; Chipbasis 

move.|l #copperlist,$80(a6) ; Adresse der Copperliste 
move.w #0,$88(a6) ; Copperliste starten 
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Tr Tr r 
wait: 
btst #10,$dff016 ‚ auf rechte Maustaste warten 
bne wait 
 _movel gfxbase,a0 ; graphicsbase 
move.| 38(a0),$80(a6) ; Adresse der alten Copperliste 
move.w #0,$88(a6) ; und starten 
move.l gfxbase,a1 
move.l 4,36 
jsr -414(a6) ; CloseLibrary () 
rts ; Ende 
ya Parameter ---- 
gfxbase: dc.! 0 
gfxname: dc.b "graphics.library",O 
even 
"section Copperlist,data c _ ; Copperliste ins CHIP-RAM 
Copperlist: 
dc.w $1001,$fffe ; Wait $10 
dc.w $0180,$0000 ; Color00 = 0 
dc.w $5001 ,$fffe ; Wait $50 
dc.w $0180,$0100 ; Color00 = 256 
dc.w $a001,$fffe ; Wait $a0 
dc.w $0180,$0500 
dc.w $ffff, $fffe ; Ende 
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10. Playfields 


Der Amiga-Bildschirm besteht aus mindestens einem Screen, welcher 
von einem Rahmen umrandet ist. Der Screen, auch Playfield genannt, 
besteht aus ein bis sechs Bitmaps (acht bei AA-ChipSet). Eine Bitmap 
ist genauso groß wie der Screen und enthält die Informationen, wo 
und in welcher Farbe ein Punkt auf dem Screen erscheinen soll. 


Der Amiga bietet eine sehr große Palette von Playfieldmöglichkeiten 
und ab ECS-Amigas sogar freiprogrammierbare Playfields. 


Einige Playfieldmöglichkeiten: 


- Farbanzahl zwischen 2 und 4096 (16,8 Millionen bei AA-ChipSet) 
- verschiedene Auflösungen (Lores, Hires, SuperHires etc.) 

- zwei unabhängige Playfields (Dualplayfield) 

- Scrolling 


10.1 Playfieldaufbau 


Da der Bildschirm eines Monitors oder Fernsehers, aus technischen 
Gründen, immer abgerundete Kanten, unser Screen hingegen aber 
vier Ecken besitzt, entsteht immer ein Rand an allen vier Seiten auf 
dem kein Bild dargestellt wird (siehe Bild 10.a). 


Die Größe dieses Rahmens läßt sich jedoch einstellen, bis fast auf 


Null. Dabei ist allerdings zu beachten, je kleiner der Rahmen ist, 
desto weinger Sprites können dargestellt werden. 
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Bild 10.a 
(Vx=588, Hx=58B) Monitorrahnon 
Bildschirm- 
N rahmen => 
Kr Farbe aus 


(V«=$2B,Hx=$81) 


eilgentlicher 


AMIGA Screen 


DINSTOP % 
(Ve=$2B ,Hx=$C1) Fi 





Je kleiner man den Rahmen macht, desto größer wird der eigentliche 
Bildschirm. Der Amiga erlaubt eine fast freie Positionierung der 
linken oberen und rechten unteren Ecke des Bildschirms. Dazu 
existieren zwei Register, die die gewünschten Werte festlegen. 


Das Register DIWSTRT (Display Window Start) legt die horizontale 
und vertikale Startposition (X,Y) des Bildschirmes fest und das 
Register DIWSTOP (Display Window Stop) enthält die Endposition + 
1 (Größe des Bildschirms). 


Alles was außerhalb des sichtbaren Bildschirmbereichs liegt, gehört 
zum Rahmen und wird in der Farbe aus dem COLOROO-Register 
angezeigt. 
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Bitbelegung der beiden Register: 
DIWSTRT ($DFFOSE) DIWSTOP ($DFFO90) 


Bit; 15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00 
Funktion: V7 V6 V5 V4 V3 V2 V1 VO H7 H6 H5 H4 H3 H2 Hl HO 


Vx = vertikale Position (Y) 
Hx = horizontale Position (X) 


Wie zu erkennen ist, sind nur Werte bis 255 möglich. Deswegen 
bezieht sich die Startposition in DIWSTRT nur auf das obere linke 
Viertel des Bildschirms. 


Die horizontale (X) Stopposition des Bildschirms bezieht sich auf das 
untere rechte Viertel, wodurch sich Werte von 256 bis maximal 458 
einstellen lassen (HStop=Hx+256). Bei der vertikalen Stopposition 
sind Werte kleiner als auch größer 256 möglich. Abhängig ist dieses 
von dem V7-Bit. Ist es auf Null sind Werte von 256 bis 312, ist es 
hingegen auf Eins, sind Werte von 128 bis 255 einstellbar. 


Die Start- und Stopwerte sind nicht beliebig wählbar. Sie können erst 
frühstens nach der Austästlücke beginnen, die durch das Rücklaufen 
des Rasterstrahls auf die Anfangsposition entsteht. Die vertikale 
Austastlücke beträgt 26 Zeilen und die horizontale liegt zwischen 30 
bis 106. 


Frühsten Start- Stopwerte: 


vertikal 
horizontal 


26 ($1A) 
106 ($6B) 


normale DIWSTRT- und DIWSTOP-Werte: 


DIWSTRT = $2B81 ($2C81) 
DIWSTOP = $2BC1 ($2CC1) 
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Ab ECS-Amigas ist ein weiteres Register hinzugekommen, mit dem 
man die Bildschirmgröße noch weiter dehnen und einfacher bedienen 
kann. Das Register trägt die Bezeichnung DIWHIGH und liegt ab der 
Adresse $DFFIE4. Die Startwerte beziehen sich dann vertikal auf die 
2/3 des oberen und horizontal auf die 3/4 des linken Bildschirm- 
bereichs. Die Stopwerte beziehen sich vertikal auf die untere Hälfte 
und horizontal auf das rechte 1/4 des Bildschirmbereichs. 


Bitbel ECS-DIWHIGH-Register: 


DIWHIGH ($DFF1E4) 


Stop | Start 
Bit: 15 14 13 12 11 10 09 08 | 07 06 05 04 03 02 01 00 
Funktion: 0 0OH8 0 o vo vsve| oO -H8 0 0 vıo v9 v8 


Sie müssen dieses Register nicht unbedingt programieren; es reicht 
auch aus, wenn Sie die "normalen" richtig setzen. 


Hat man die Position des Bildschirmfensters festgelegt, so müssen 
jetzt noch Anfang und Ende des Bitplane-DMAs berechnet werden. 
Das heißt, wann die Ausgabe der Bildschirmdaten geschehen soll. 


Vertikal beginnt und endet die Ausgabe synchron mit der 
Bildschirmfensterposition (DIWSTRT, DIWSTOP). Horizontal sieht die 
Sache etwas anders aus. Da der Amiga in einem Buszyklus nur zwei 
niedrig- bzw. vier hochauflösende Punkte lesen kann und zusäzlich 
noch einen halben Buszyklus braucht, bevor die Daten auf dem 
Screen erscheinen, muß der Biplane-DMA schon etwas früher ge- 
startet werden. 


Die Werte werden in den Registern DDFSTRT und DDFSTOP abgelegt, 
welche nach folgende Formeln berechnet werden: 
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Berechnung von DDFSTRT: 


DDFSTRT = (Hx von DIWSTRT / 2) - 8,5 =>LoRes 

DDFSTRT = (Hx von DIWSTRT / 2) - 4,5 => HiRes 

DDFSTRT = (81 / 2) - 8,5 = $38 => Normal LoRes Wert 

DDFSTRT = ($81 / 2) - 4,5 = $S3C => Normal HiRes Wert 
Berechnung von DDFSTOP: 

DDFSTOP = DDFSTRT + 8 * ((Screenbreite/16)-1) =>LoRes 

DDFSTOP = DDFSTRT + 4 * ((Screenbreite/16)-2) => HiRes 

DDFSTOP = $38 + 8 * ((320/16)-1) = $DO => Normal LoRes Wert 

DDFSTOP = $3C + 4 * ((640/16) -2) = $D4 => Normal HiRes Wert 


ACHTUNG!- Die Screenbreite muß immer durch 16 teilbar sein. 


Möchte man den DDFSTRT-Wert mit Hilfe einer Assemblerroutine 
berechnen, so stören im ersten Augenblick die Kommazahlen (8,5 
bzw. 4,5). Diese braucht man aber nicht zu beachten. Denn, wenn 
wir eine Zahl in Assembler durch zwei teilen, erhalten wir 
automatisch eine gerade Zahl, von der wir dann 8 bzw. 4 abziehen. 


zum Beispiel: 
move.w #%81,d0 ;Hx von DIWSTRT 
Isr.w #1,d0 ; durch 2 teilen 
move.w dO,dI ; für Hiresberechnung 
subq.w #8,d0 ; DO =DDFSTRT (LoRes) 
subq.w #4,d1 ; DI = DDFSTRT (HiRes) 
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Die Bitbelegung der beiden Register ist folgende: 
DDFSTRT ($DFFO92) DDFSTOP ($DFFO94) 


Bit: 15 14 13 12 11 10 09 08 07 06 05 04 83 02 01 00 
Funktion: 0 0 000 0 0 OH8 H7H6 H5 H4 H3 0 0 


Hx = horizontaler Bitplanestart (X) 


=> H3 wird nur in Hi-Res (Screenbreite = 640) benutzt. 


Möchte man das Bildschirmfenster horizontal verschieben, so muß die 
Differenz zwischen DIWSTRT und DDFSTRT folgenden Wert haben: 


((Hx von DIWSTRT) /2) -DDFSTRT 
((Hx von DIWSTRT) /2) -DDFSTRT 


8,5 =>LoRes 
4,5 => HiRes 


Ist dieses der Fall, so würde ein Teil des ersten Datenwortes links 
unter dem Bildschirmrahmen verschwinden. Um besagten Effekt zu 
verhindern, muß man die entsprechende Anzahl Punkte vorher nach 
rechts scrollen. 


Der Bildschirm kann maximal um 15 Punkte nach rechts verschoben 
werden. Deswegen sollte die Bildschirmbreite auch immer durch 16 
teilbar sein, damit kein größerer Rest als 15 entsteht. Der Scrollwert 
wird in dem Register BPLCON1 und zwar für die ungeraden (1/3/5) 
und geraden Planes (2/4/6) getrennt eingestellt. 


Bitbel von BPL 1 ($DFF102): 


Bit: 15-8 07 06 05 04 03 02 01 00 
Funktion: 00 P2H3 P2H2 P2H1 P2HO P1H3 P1H2 P1H1 P1HO 


PIHO bis PIH3 = Position der ungeraden Planes (vier Bits) 
P2HO bis P2H3 = Position der geraden Planes (vier Bits) 
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Nachdem wir die Position des Bildschirmfensters und die Screenbreite 
festgelegt haben, müssen wir der Bitplane-DMA noch mitteilen, ab 
welcher Adresse der Screen im Speicher liegt, aus dem die DMA ihre 
Daten ließt und auf dem Bildschirm ausgibt. 


Wie Anfangs schon erwähnt wurde, besteht der Amiga-Screen aus 
sogenannten Bitmaps, welche genauso groß sind, wie der eigentliche 
Screen. Besitzt der Screen eine Breite von 320 Punkten und eine 
Höhe von 256 Zeilen, so ergibt das eine Bitmapgröße von 320 * 
256 = 81920 Pixeln (10240 Bytes). Überall, wo ein Punkt in der 
Bitmap gesetzt ist, erscheint auch ein Punkt auf dem Bildschirm. 
Damit kann man die Zustände Punkt gesetzt (1) bzw. Punkt gelöscht 
(0) festlegen. Aber in welcher Farbe dieser erscheinen soll, kann nicht 
bestimmt werden. Deswegen nimmt man mehrere Bitmaps von 
gleicher Größe und legt diese übereinander. Es können bis zu sechs 
Bitmaps übereinander gelegt werden. Jetzt hängt es davon ab, in 
welcher Bitmap wir einen Punkt setzen. Zum Beispiel bei fünf 
Bitmaps, ergibt dieses 2°5 = 32 mögliche Kombinationen. Über 
diesen Wert errechnet dann die Hardware die Nummer des 
dazugehörigen Farbregisters, aus dem die Farbe genommen wird, in 
der der Punkt erscheinen soll (siehe Bild 10.b). 


Bild 10.b 





5 Bitzahl als Zeiger auf Farbregister 
alılıjıle - Wert IC Farbregistar SDFF190+ 1482) 





5 Bitplanes, die uebereinander liegen 
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BE = Punkt gesetzt 
U) = Punkt seloesoht 
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Die Adressen der Bitmaps, werden in folgenden Hardware-Registern 


abgelegt: 
N ij 

SDFFOEO BPLIPTH Anfangsadresse von Bitmap 1 (Hi-Word) 
SDFFOE2 BPLIPTL Anfangsadresse von Bitmap 1 (Lo-Word) 
$SDFFOE4 BPL2PTH Anfangsadresse von Bitmap 2 (Hi-Word) 
SDFFOE&6 BPL2PTL Anfangsadresse von Bitmap 2 (Lo-Word) 
$SDFFOE8 BPL3PTH Anfangsadresse von Bitmap 3 (Hi-Word) 
SDFFOEA BPL3PTL Anfangsadresse von Bitmap 3 (Lo-Word) 
$SDFFOEC BPLAPTH Anfangsadresse von Bitmap 4 (Hi-Word) 
$SDFFOEE BPLAPTL Anfangsadresse von Bitmap 4 (Lo-Word) 
SDFFOFO BPL5SPTH Anfangsadresse von Bitmap 5 (Hi-Word) 
$DFFOF2 BPL5SPTL Anfangsadresse von Bitmap 5 (Lo-Word) 
$SDFFOF4 BPL6PTH Anfangsadresse von Bitmap 6 (Hi-Word) 
$SDFFOF6 BPL6EPTL Anfangsadresse von Bitmap 6 (Lo-Word) 
SDFFOF8 BPL7PTH Anfangsadresse von Bitmap 7 (Hi-Word) (AA) 
SDFFOFA BPL7PTL Anfangsadresse von Bitmap 7 (Lo-Word) (AA) 
SDFFOFC BPL8PTH Anfangsadresse von Bitmap 8 (Hi-Word) (AA) 
SDFFOFE BPL8PTL Anfangsadresse von Bitmap 8 (Lo-Word) (AA) 


=>Die Bitmaps 7 und 8 exestieren nur bei Amigas mit AA-Chipset 
oder höher (1204000). 


Man kann auch mit einem "move.|"-Befehl die Adresse einer Bitmap 
auf einmal in das entsprechende Register schreiben. 
move.| #bitmap1,$DFFOEO 


Zum Beispiel: ; Bitmap]1 setzen 


Bei der Bildschirmausgabe werden die einzelnen Daten wordweise 
(16 Pixel), über die Bitmapadressen, von der Bitplane-DMA gelesen 
und in die BPLxDat-Register geschrieben, wo diese zusammen über 
die Videologik auf dem Bildschirm, in der entsprechenden Farbe 
ausgegeben werden. Danach werden die Bitmapadressen um ein 
Word (zwei Bytes) erhöht und der ganze Vorgang wiederholt sich, bis 
das gesamte Bild dargestellt wurde. Jetzt braucht der Rasterstrahl 
einige Zeit, bis er wieder auf den Anfangswert gesetzt wird 
(Austastlücke), um mit der Arbeit erneut zu beginnen (50 mal in der 
Sekunde =>PAL). Die Bitmapadressen stehen jedoch noch auf dem 
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alten Wert und müssen von Ihnen selbst zurückgesetzt werden. Am 
besten läßt man dieses über eine Copperliste den Copper erledigen. 
Ansonsten würde ständig ein anderes Bild erscheinen, was ein wirres 
Flackern zur Folge hätte. 


Die Bitmapdaten der Bitmaps, werden über die DMA in folgenden 
Hardware-Registern abgelegt: 


Adresse Name Funktion 
SDFF110 BPLIDAT Bitplane Daten zum RGB-Ausgang 


1 
SDFF112 BPL2DAT Bitplane 2 Daten zum RGB-Ausgang 
SDFF114 BPL3DAT Bitplane 3 Daten zum RGB-Ausgang 
SDFF116 BPLADAT Bitplane 4 Daten zum RGB-Ausgang 
SDFF118 BPL5SDAT Bitplane 5 Daten zum RGB-Ausgang 
SDFF11A BPL6DAT Bitplane 6 Daten zum RGB-Ausgang 
SDFF11C BPL7DAT Bitplane 7 Daten zum RGB-Ausgang (AA-ChipSet) 
SDFF1lE BPL8DAT Bitplane 8 Daten zum RGB-Ausgang (AA-ChipSet) 


=>Die Register werden automatisch mit den richtigen Werten 
geladen. Sie brauchen sich also nicht darum zu kümmern. 


Da der normale Amiga eine Palette von 4096 Farbtönen besitzt, aber 
nur 32 Farbregister, können auch nur maximal 32 verschiedene 
Farben auf dem Bildschirm ausgegeben werden. Jeder der 
Farbregister kann einen der 4096 Farbtöne aufnehmen. Diese 4096 
Farben werden durch Mischen aus den drei Grundfarben Rot, Grün 
und Blau hergestellt. Die Farbregister liegen ab folgender Adresse im 
Speicher: 


Böropse Bome Puonkticn  _ a 
SDFF180 COLOROO Farbregister 0 (Hintergrund- und Rahmenfarbe) 
SDFF182 COLORO1 Farbregister 1 

USW. 
SDFF1BE COLOR31 Farbregister 31 
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Bitbelegung der Farbregister: 


Bi: 15 14 13 12 11 10 09 08 07 06 05 84 03 02 01 00 
Funktion: 0 0 0 O0OR3 R2 Ri RO G3 G2 G1 GO B3 B2 Bi BO 


RO bis R3 = Rotanteil (vier Bits = 16 Werte) 
GO bis G3 = Grünanteil (vier Bits = 16 \WVerte) 
BO bis B3 = Blauanteil (vier Bits = 16 Werte) 


Oft wäre es von Vorteil, einen Screen zu erzeugen, der größer als der 
eigentliche Bildschirm ist, von dem immer nur ein Teil angezeigt wird 
und ruckfrei in alle Richtungen scrollen kann. Beim Amiga läßt sich 
dieses kinderleicht realisieren. 


Möchte man einen Screen erstellen, der 512 Zeilen hoch ist, von den 
aber immer nur 256 Zeilen angezeigt werden, so legt man die 
gewünschte Anzahl von Bitmaps mit der Höhe 512 im Speicher ab 
und schreibt die Anfangsadressen dieser in die BPLxPT-Register. 
Addiert man jetzt die Länge einer Zeile in Bytes zu den Adressen so 
scrollt der Bildschirm eine Zeile hoch und umgekehrt (subtrahiert) 
eine Zeile nach unten. 


Horizontal ist es nicht wesentlich komplizierter. Wir gehen genau wie 
beim Vertikalscrolling vor und legen zum Beispiel eine Bitmap an, die 
640 Pixel (80 Bytes) breit ist, von denen aber nur 320 Pixel 
angezeigt werden sollen. Das Problem, welches hier jetzt auftaucht, 
ist, daß die restlichen 40 Bytes (320 Pixel) von der Hardware 
übersprungen werden müssen, damit die nächste Zeile richtig 
angezeigt wird. Für diesen Zweck exestieren die Modulo-Register 
BPLIMOD und BPL2MOD. In diesen Registern wird die Differenz in 
Bytes zwischen der großen und kleinen Bitmap eingetragen. Für 
dieses Beispiel wären das 80 - 40 = 40 Bytes. 


N i 
$SDFF108 BPLIMOD Modulo-Wert für ungerade Planes (1/3/5) 
SDFF10A BPL2MOD Modulo-Wert für gerade Planes (2/4/6) 
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Möchte man jetzt nach rechts scrollen, so erhöht man den Scrollwert 
im Register BPLCON1 pixelweise bis auf 15. Als nächstes erhöht man 
die Bitmapadressen um zwei Bytes und setzt den Scrollwert wieder 
auf Null usw.. Für Scrollen des Screens nach links geht man genau 
umgekehrt vor. 


Es sind auch negative Modulo-Werte möglich. Damit kann man zum 
Beipiel über den Copper den Screen spiegeln. Das Scrolling sollte 
sowieso über den Copper, während der Austastlücke berechnet 
werden. 


Jetzt fehlt uns noch ein Register, in dem wir festlegen wieviele 


Farben, also wieviel Bitmaps und was für ein Modus wir verwenden 
möchten. 


Dieses wird im Register BPLCONO festgelegt, welches folgende Bitbe- 
legung hat: 


BPLCONO ($DFF100): 


Bit Name Funktion wenn Bit = 1 
15 HIRES hochauflösender Modus ein (Screenbreite 640) 
14 BPU2 Diese drei Bits legen 
13 BPUl die Anzahl Bitmaps und damit 
12 BPUO die Anzahl Farben fest (0 bis 6) 
11 HAM Hold &Modify Modus ein (4096 Farben gleichzeitig) 
10 DPF Dualplayfield Modus ein (zwei unabhängige Screens) 
9 COLOR Videoausgang auf Farbe (für Amiga 1000) 
8 GAUD Genlock Audio einschalten 
T ------ unbenutzt 
6 SHRES Superhires Modus ein (Screenbreite 1280) [ab ECS] 
5 BPLHWRM unbekannte Funktion [ab ECS] 
4 SPRHWRM unbekannte Funktion [ab ECS => siehe AA-Kapitel] 
3 LPEN LightPen-Eingang aktivieren 
2 LACE Interlace-Modus aktivieren (doppelte Screenhöhe) 
1 ERSY Bildschirmausgabe extern synchronisieren (Genlocks) 
0 ENBPLCN3 aktivieren des Registers BPLCON3 [ab ECS] 


Die einzelnen Modi und deren Aktivierung werden im nächsten 
Abschnitt beschrieben. 
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Das Register BPLCON3 ist erst ab ECS-Amigas und höher vorhanden 
und hat folgende Bitbelegung: 


BPLCON3 ($DFF106): 
Bit _ _ Name Funktion wenn Bit = 1 
15-6 ------- unbenutzt [siehe AA-Kapitel] 
5 BRDRBLNK Bildschirmrand ausschalten (schwarz) 
4 BRDNTRAN Bildschirmrand transparent 
3-0 ----- - - unbenutzt 


Der Amiga ist ab ECS-Hardware in der Lage den Bildschirmaufbau 
frei zu programmieren; unter anderem den Productivity-Modus. Dafür 
sind einige neue Register hinzugekommen. Da die Funktionsweise 
teilweise noch nicht dokumentiert ist, ist die Programmierung mit 
Vorsicht zu genießen, da die Gefahr besteht, daß Sie Ihren Monitor 
zerstören. Der Vollständigkeithalber werden die Register im 
Folgenden aufgelistet und soweit wie möglich beschrieben. 


Das erste Register ist das BEAMCONO-Register. Es ist sozusagen das 
BPLCONO-Register unter den Neuen und somit wohl das wichtigste 
für die freie Programmierung der Bildschirmerzeugung. 


B DFF1 r mmi igna . 
Bit Name Funktion wenn Bit = 1 
15 ------- unbenutzt 


14 HARDDIS verdrahteten V- und H-Blank abschalten 

13 LPENDIS gespeicherten LightPen-Wert beim Y-Lesen ignorieren 
12 VARVBEN Benutze VBSTRT u. VBSTOP statt normalen VBlank 
11 LOLDIS verbieten des Lang-/Kurzzeilenumschaltens 

10 CSCBEN Composite Sync-Redirection 

9 VARVSYEN variable vertikale Synchronisation einschalten 
VARHSYEN variable horizontale Synchronisation einschalten 
VARBEAMEN variablen Rasterstrahlzähler-Vergleicher ein 
DUAL speziellen Ultraauflösungsmodus einschalten 

PAL PAL-Bildschirmmodus einschalten 

VARCSYEN variable Composite-Synchronisation einschalten 
BLANKEN Composite Blank-Redirection 

CSYTRUE Polarität des Hardware C-Sync-Anschlusses 
VSYTRUE Polarität des Hardware V-Sync-Anschlusses 
HSYTRUE Polarität des Hardware H-Sync-Anschlusses 


oOoOPDDW»Pu An 0 
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Wird die H- und VSync-Verdrahtung (Bit 14=1) abgeschaltet, kann 
über die Register HTOTAL und VTOTAL die Bildwechselfrequenz 
eingestellt werden. Das Register HTOTAL bestimmt die Anzahl 
Farbzyklen pro Zeile (Bildbreite) und VTOTAL die Bildhöhe. 
Nachstehende Werte sind dafür in der graphics.library definiert 


NTSC (15,6 KHz 
VTOTAL: 525 Zeilen, HTOTAL:227,5 Farbzyklen pro Zeile 


PAL (15,6 KHz) 
VTOTAL: 625 Zeilen, HTOTAL: 227,5 Farbzyklen pro Zeile 


VGA (31,4 KHz) 
VTOTAL: 525 Zeilen, HTOTAL: 114,0 Farbzyklen pro Zeile 


Bitbelegung der beiden Register HTOTAL und VTOTAL: 


HTOTAL ($DFF1CO) VTOTAL ($DFF1C8) 
Bit: 15 14 13 12 11 10 09 08 07 06 085 04 03 02 01 080 
HTOTAL: 00%» 80 80 O2 O0 H8 H7 H6 H5 HA H3 H2 Hi 
VTOTAL: 009090 90 08 0 OO V8 V7 V6 V5 Va V3 V2 V1 


Hx = horizontale Bildbreite 
Vx = vertikale Bildhöhe 


Das Bildschirmfenster wird dann nicht mehr über die DIWSTRT und 
DIWSTOP-Register definiert, sondern über die folgenden: 


Adresse _N tion 

SDFF1EO VSSTRT vertikale Startpos. wenn VARVSYEN = 1 
SDFF1ICA VSSTOP vertikale Endposition 

SDFFIDE HSSTRT horizontale Startpos. wenn VARHSYEN = 1 
SDFF1C2 HSSTOP horizontale Endposition 

SDFF1E2 HCENTER horizontale Position wenn Interlace ein 
SDFF1C4 HBSTRT horizontale Startpos. des HBlanks 
SDFF1C6 HBSTOP horizntale Endposition des HBlanks 
SDFFICC VBSTRT vertiakle Startpos. des VBlanks 

SDFFICE VBSTOP vertikale Endposition des VBlanks 
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Die Register sollten wie folgt berechnet werden: 


HCENTER HSSTRT / 2 
HBSTOP HSSTOP-HSSTRT und kleiner als HCENTER 
HBSTRT = HSSTOP-HSSTRT und kleiner als HSSTRT 


Als letztes fehlt uns noch das BPLCONZ2-Register, mit dem man die 
Prioritäten der Playfields und Sprites untereinander einstellen kann. 
Dieses Register finden wir in jedem Amiga wieder. In einigen (ab 
ECS) ist es aber etwas erweitert worden. 


BPLCON2 ($DFF104): 
Bit Name Funktion wenn Bit = 1 
15 ------- unbenutzt 
14 ZDBPSEL2 Funktion dieser [ab ECS] 
13 ZDBPSEL1 drei Bits [ab ECS] 
12 ZDBPSELO unbekannt [ab ECS] 
11 ZDBPEN benutze Bitplane-Key [ab ECS] 
10 ZDCTEN benutze Color-Key [ab ECS] 


9 KILLEHB Halfbrite Modus unterdrücken, bei 6 Bitplanes [ECS] 
8 ---- --- unbenutzt 

T  +---r--- unbenutzt (siehe AA-Kapitel) 

6 PF2PRI gerade Planes vor ungeraden (nur bei Dualplayfield) 
5 PF2P2 Priorität der 

4 PF2P1 Sprites in Bezug 

3 PF2PO auf die geraden Planes 

2 PFIP2 Priorität der 

ı PFIP1 Sprites in Bezug 

0 PFIPO auf die ungeraden Planes 


Für die Priorität der Sprites untereinander gilt, daß das Sprite mit der 
kleinsten Nummer vor allen anderen liegt. Für die Priorität in Bezug 
auf die Playfields werden immer Spritepaare (0 und 1, 2 und 3, 4 
und 5, 6 und 7) in Abhängigkeit von dem Dreibitwert der PFxPx wie 
folgt gesetzt: 
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PF1Px-Wert Priorität von oben h ten 





000 PF1 SPO1 SP23 SP45 SP67 
001 sSPpOo1ı PFi1 SP23 SP45 SP67 
010 SPO1 SP23 PF1 SP45 SP67 
oll SPO1 SP23 SP45 PF1 SP67 
100 SPO1 SP23 SP45 SP67 PF1 
PF2Px-Wert Priorität von oben nach unten 
000 PF2 SPO1 SP23 SP45 SP67 
001 SPO1 PF2 SP23 SP45 SP67 
010 SPO1 SP23 PF2 SP45 SP67 
oll SPO1 SP23 SP45 PF2 SP67 
100 SPO1 SP23 SP45 SP67 PF2 

PF1 = Playfield 1 (ungerade Planes) 

PF2 = Playfield 2 (gerade Planes) 

SPO1 = Spritepaar 0 und 1 

SP23 = Spritepaar 2 und 3 

SP45 = Spritepaar 4 und 5 

SP67 = Spritepaar 6 und 7 


Möchte man einen Amiga-Screen erzeugen, so geht man am besten 
folgendermaßen vor: 


. Copper- und Bitplane-DMA aktivieren 

. DIWSTRT, DIWSTOP, DDFSTRT und DDFSTOP initialisieren 
. Scrolliwert (BPLCON1) und Modulo (BPLXMOD) setzen 

. Bitmapadressen eintragen (BPLxPT) 

. Farben eintragen (COLORxx) 

. Anzahl Bitmaps und Modus einstellen (BPLCONO) 


au pwpmn — 


=> die Register initialisiert man am besten mit dem Copper! 
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10.2 Grafik-Modis 


Wie aus dem BPLCONO-Register ersichtlich ist, ist der Amiga in der 
Lage einen Screen auf verschiedene Arten zu erzeugen. Dabei reicht 
die Palette von 2 bis 4096 Farben in einer Auflösung von 320 
(LoRes) bis 1280 (SuperHires). Wie diese verschiedenen Modi 
programmiert werden, soll im folgenden beschrieben werden. 


n niedrigaufl L 


In diesem Modus wird ein Punkt 140 nanosekunden lang auf dem 
Bildschirm ausgegeben. Was zur einer normalen PAL-Auflösung von 
320 x 256 führt (320 x 200 in NTSC). Es sei den, man macht das 
Bildschirmfenster kleiner (z. B.: auf 288 x 256). 


Setzen des Moclus LoRes im BPLCONO-Register- 


BPU2 bis BPUO = Anzahl Bitmaps (maximal 5) 
Color = 1 (wegen Amiga 1000) 
=> BPLCONO-Wert für 5 Bitplanes = $5200 


Der hochauflösende Modus (HiRes) 


Hier wird ein Punkt 70 nanosekunden lang auf dem Bildschirm 
ausgegeben, also können in der selben Zeit doppelt so viele Punkte 
ausgegeben werden, wie im LoRes-Modus. Die normale PAL- 
Auflösung beträgt 640 x 256 (640 x 200 bei NTSC). Allerdings 
beträgt hier die maximale Anzahl Bitplanes nur noch vier (16 
Farben). 
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Setzen des Modus HiRes im BPLCONO-Register: 


HIRES = 1 (für Hires-Modus) 

BPUZ bis BPUO = Anzahl Bitmaps (maximal 4) 
Color = 1 (wegen Amiga 1000) 

=> BPLCONO-Wert für 4 Bitplanes = $C200 


Der superhochauflösende Modus (SuperHiRes) 


In diesem Modus, der nur ab ECS-Hardware möglich ist, wird ein 
Punkt nur noch 35 nanosekunden lang angezeigt. Die normale PAL- 
Auflösung beträgt jetzt 1280 x 256 (1280 x 200 bei NTSC). Für diese 
Auflösung ist der Amiga leider etwas zu langsam und es können nur 
noch zwei Bitplanes (vier Farben) verwendet werden. Auch die Farben 
werden nach einem anderen Schema berechnet. 


Farbenschlüssel für SuperHires-Modus: 


normale Farbverteilung: Rot_Grün Blau (12 Bits) 
Bitplane- bzw. Spritefarbe 0: ab0O0 cd00 e£f00 


Bitplane- bzw. Spritefarbe 1: gh00 ij00 kl00 
Bitplane- bzw. Spritefarbe 2: mnO0O0 opO00 qr00 
Bitplane- bzw. Spritefarbe 3: st00 uvOO0 wx00 


Kombinationen => | ROT | GRÜN | BLAU 
BCRSCR_ 15 14 13 12 | 11 10 09 08 | 07 06 05 04 | 03 02 01 00 
00 16 0000 oo | aba ıb| ce de d| ee fe 
01 ER I cha | I Je dal ki mw LE 
022 18 000000060 | m nab| opedä)| gg ref 
03 19 00000000| stab| uveä| wxerL 
04 20 066 OA | as hl ee Ei iA IF IE ER 
23 5 gg hkh)| 1 I ı II EA KK 
car 2 Voir na | oa BB 2 I IS EXKL 
a: BD | ee cr ss | u vs II mw ki 
08 24 00000000| abkmn| cdop| e £ gr 
09 25 0.000 | sh ua A| 31 J oa al x ia: 
10 26 BOB |ı| man un] SH a ul Es x 
1127 eo oo | etmumn | wer op )| wer gu r 
1228 80080000 | ab ea t| ed uv]l e £E uw xXx 
13 29 DEM m sh BB ei iJIF a kI u x 
1430 9890 0000| m ns tl op uvw| gr ux 
1531: 98 095 00| e ts t]| uvuauavr)| ww x 
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BCR = COLORxx-Register der Bitplanes 

SCR = COLORxx-Register der Sprites 

horizontal 15 bis 00 = Bits in den jeweiligen Farbregistern 
vertikal 00 bis 31 = Nummern der betroffenen COLORxx-Register 


Will man jetzt die Bitplane- bzw. Spritefarbe Null haben, so muß 
überall der normale Farbwert unter ab, cd, ef in allen Farbregistern 
gesetzt werden, wo diese Buchstaben auftauchen. 


Setzen des Modus SuperHiRes im BPLCONO-Register: 


SHRES = 1 (für SuperHires-Modus) 

BPU2 bis BPUO = Anzahl Bitmaps (maximal 2) 
Color = 1 (wegen Amiga 1000) 

=> BPLCONO-Wert für 2 Bitplanes = $2240 


Achtung! - Die Modulowerte müssen evtl. geändert werden (meistens 
acht abziehen). 


Pr ivi rHiR: 


Dieser Modus ist fast identisch mit dem SuperHires, nur daß dieser 
frei programmiert wird (BEAMCONO) und die doppelte Horizontal- 
frequenz besitzt, was zur einer Verdopplung der Höhe führt (1280 x 
512). Auch dieser ist erst ab ECS-Hardware vorhanden. Das 
BPLCONDO-Register wird genauso belegt, wie im Super-Hires-Modus, 
nur müssen jetzt weitere Register entsprechend gesetzt werden. Die 
Farberzeugung läuft genau wie im Super-Hires-Modus ab. Für diesen 
Modus ist auch ein Multi-Sync-Monitor notwendig. 
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SDFFO8SE 
SDFFO9O 
SDFF1E4 
SDFFO92 
SDFFO094 
SDFF108 
SDFF10A 
SDFF100 
SDFF1CO 
SDFF1C8 
SDFF1DE 
SDFF1C2 
SDFFI1EO 
SDFFICA 
SDFFI1E2 
SDFF1C4A 
SDFF1C6& 
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Beispielwerte für einen Productivity-Screen: 


DIWSTRT 
DIWSTOP 
DIWHIGH 
DDFSTRT 
DDFSTOP 
BPL!MOD 
BPL2MOD 
BPLCONO 
HTOTAL 
VTOTAL 
HSSTRT 
HSSTOP 
VSSTRT 
VSSTOP 
HCENTER 
HBSTRT 
HBSTOP 


$1D45 Windowstartposition 

SFDE5S Windowendposition 

50100 Windowstop V8 setzen 

$0020 Bitplane-DMA Startposition 
$0068 Bitplane-DMA Stopposition 
$S0000 Modulo = 0 

S0o000 Modulo = 0 

$2241 2 SuperHires Planes + BPLCON3 
50071 

So20C 

S0O00E 

soolc 

$0003 

50005 

50046 

50008 

SOO1E 


aktiv 


SDFFICC 
SDFFICE 
SDFF104 
SDFF106 
SDFFIDC 


VBSTRT 50000 

VBSTOP $001D 

BPLCON2 $0012 Priorität 

BPLCON3 50021 Bildrahmen schwarz 
BEAMCONOS1B88 doppelte Horizontalfrequenz 


Mann kann sich diese Werte leicht, mit Hilfe eines Coppermonitors, 
aus der Copperliste der Workbench schreiben. Dieses gilt auch für 
alle anderen Bildschirmmodis. 


Der Interlace Modus 


Mit Hilfe des Interlace-Modus kann in jedem anderem Modus die 
Bildschirmzeilenanzahl verdoppelt werden. Es werden dann immer 
abwechselnd mit jedem Bild die geraden bzw. ungeraden Zeilen 
ausgegeben, das hat zur Folge, daß die Bildwiederholfrequenz auf 
die Hälfte sinkt (bei PAL auf 25 HZ), erkennbar durch ein Flimmern. 
Damit das Bild richtig erscheint, ist es erforder-lich die Modulowerte 
so zu setzen, daß jeweils eine Zeile über- sprungen wird. Damit auch 
wirklich immer nur die geraden bzw. ungeraden Zeilen für einen 
Bildaufbau benutzt werden. Dieses macht zwei Copperlisten 
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erforderlich. Über die erste werden immer die BPLxPT-Register mit 
den Adressen der ersten Zeile und mit der zweiten werden sie mit 
der Adresse der zweiten Zeile der Bitmaps geladen. Am Ende jeder 
Copperliste wird dann die jeweils andere gestartet. 


Copperlisten für ein Interlace-Screen: 


CopperListi: 

dc.w BPLxPTH, Zeilel HiWord 

dc.w BPLxPTL,Zeilel_LoWord 

dc.w COPILCH, CopperList2_HiWord 

dc.w COPILCL,CopperList2_LoWord 

dc.w $Sffff,$fffe ; Copperende 
CopperList2: 

dc.w BPLxPTH, Zeile2 HiWord 

dc.w BPLxPTL,Zeile2 LoWord 

dc.w COP2LCH, CopperList1_HiWord 

dc.w COP2LCL,CopperListi1 LoWord 

dc.w $£f£fff£f,S$fffe ; Copperende 
Zeilel = Bitplaneadresse der ersten Zeile 
Zeile2 = Bitplaneadresse der zweiten Zeile 


Damit das Timing für den Start der Copperliste stimmt, muß folgen- 
dermaßen vorgegangen werden: 


1) auf Austastlücke warten 

2) Copper-DMA einschalten 

3) Interlace-Modus ein (siehe unten) 

4) LOF-Bit (15) im VPOS-Register auf Null setzen. Dieses stellt sicher, 
daß nach dem Einschalten des Interlace-Modus das erste Halbbild 
zur ersten Copperliste paßt. 

5) COPILCx auf die Adresse der 1. Copperliste setzen + starten 


Ansonsten ändert sich an den anderen Registerfunktionen nichts. 
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Setzen des Modus Interlace im BPLCONO-Register: 


LACE = 1 (für Interlace) 
=> alle anderen Bits bleiben unverändert (abhängig vom 
eingestellten Modus) 


Der HAM-Modus (Hold and Modify) 


Durch diesen Modus ist es möglich, die gesamten 4096 Farben des 
Amigas aufeinmal darzustellen. Allerdings mit einem kleinen 
Nachteil. Dieser Modus kann nur im LoRes-Betrieb verwendet werden 
und benötigt alle sechs Bitplanes. 


Man macht sich hier die Technik zu nutze, daß der Farbübergang von 
einem Punkt zum anderen fließend und nicht sprunghaft verläuft. Das 
heißt, das die Farbe des vorangegangenen Punktes vom nächsten 
modifiziert wird. Dieser Punkt bekommt nur einen anderen Rot-, 
Grün-, oder Blauwert zugeteilt. Die restlichen Farbkomponenten 
bleiben unverändert. Damit kann ein Farbwert erst nach drei Punkten 
vollständig geändert werden. Es besteht aber noch die Möglichkeit 
auf 16 Echtfarben zuzugreifen und damit die Farbe gleich zu ändern. 


Wie wird nun der Farbwert im HAM-Modus definiert? 


Die beiden Bits (4 und 5) aus den beiden höhsten Bitmaps (5 und 6) 
bestimmen die Verwendung der unteren Bits (0 bis 3) aus den 
Bitmaps (1 bis 4). Sind diese beiden Bits Null, so wird der Punkt in 
der Farbe aus einem der Farbregister von O bis 15 dargestellt, 
welches von den unteren Bits festgelegt wird. Ansonsten bestimmen 
die beiden Bits, welche Farbkomponente vom vorangegangen Punkt 
geändert werden soll. Die Farbkomponente erhält dann den Wert aus 
den unteren Bits (OD bis 3). Die restlichen Farbanteile werden 
übernommen. 
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00 Farbwert aus COLORxx-Register 

01 Blauanteil ersetzen durch Bits 0 - 3 
10 Rotanteil ersetzen durch Bits 0 - 3 
il Grünanteil ersetzen durch Bits 0 - 3 


Setzen des HAM-Modus im BPLCONO-Register: 


HAM = 1 (für HAM-Modus) 

BPU2 bis BPUO = 6 

Color = 1 (wegen Amiga 1000) 

=> BPLCONO-Wert für HAM = $6A00 


Bei der AA-Hardware hat sich der HAM-Modus etwas geändert. Doch 
dazu mehr im entsprechendem Kapitel. 


Der Extra-Halfbrite-Modus 


Dieser Modus funktioniert ähnlich wie der HAM-Modus. Auch hier 
werden alle sechs Bitmaps benötigt und ist somit auch nur im LoRes- 
Modus aktivierbar. 


Mit den 6 Bitmaps erhält man einen Wertebereich von O bis 63. 
Soviele Farbregister besitzt der Amiga aber nicht (nur 32 COLORxx- 
Register). Deswegen wird mit Hilfe der sechsten Bitmap festgelegt, 
ob die Farbe aus einem der normalen Farbregister entnommen (wenn 
Bit=0) oder die Farbe vor der Ausgabe halbiert werden soll (wenn 
Bit=1). Dieses halbieren hat zur Folge, daß der Punkt nur noch in 
der halben Helligkeit erscheint. 


Setzen des ExtraHalfbriteModus im BPLCONO-Register: 
HAM = 0 (damit nicht HAM-Modus aktiv) 
BPU2 bis BPUO = 6 


Color = ] (wegen Amiga 1000) 
=> BPLCONO-Wert für EHB = $6200 
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Der Dualplayfield-Modus 


In diesem Modus werden zwei Displays erzeugt, die unabhängig 
voneinander bewegt werden können. Dabei wird dann zwischen den 
geraden und ungeraden Bitmaps unterschieden. Es können jeweils 
maximal 3 Bitmaps zu einem Display zusammengefaßt werden (1, 3 
und 5 oder 2, 4 und 6). Darum lassen sich die Werte für Modulo 
und Scrolling auch immer getrennt einstellen. Bei maximal drei 
Bitmaps stehen einem acht Farben für ein Display zur Verfügung. Das 
erste Display (ungerade Bitmaps) bekommt dafür die Farbregister O 
bis 7 und das zweite die Farbregister 8 bis 15 zugeteilt. Überall wo 
die Bitkombination Null ist, erscheint, je nach Priorität, das andere 
Display hindurch. 


Mit diesem Modus lassen sich so Tricks wie Parallax-Scrolling er- 
zeugen und einiges mehr. 


Der Dualplayfield-Modus funktioniert in allen Modi, außer im HAM 
und ExtraHalfbrite, unter Berücksichtigung der Bitmapanzahl. 


Setzen des Dualplayfield-Modus im BPLCONO-Register: 
DPF = 1 (Dualplayfield-Modus ein) 
BPU2Z bis BPUO = Bitmapanzahl (maximal 6) 


Color = 1 (wegen Amiga 1000) 
=> BPLCONO-Wert für 6 Bitplanes = $6600 
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10.3 Double-Buffering 


Möchte man Animationen blitzschnell und ruckfrei ablaufen lassen, so 
muß man das Double-Buffering anwenden. Dafür muß man zwei 
Screens gleicher Größe anlegen. Während man jetzt auf den einen 
Screen schaut, wird die nächste Animatonsphase auf dem anderen 
unsichtbaren Screen aufgebaut und danach aktiviert. Das Aktivieren 
darf allerdings nicht zu einem beliebigen Zeitpunkt geschehen, da es 
sonst zu einem Flackern der Grafik kommen würde. Der 
frühstmöglichste Zeitpunkt wäre ab die letzte Zeile des Bildes das 
Umschalten vorzunehmen. 


Man kann natürlich auch mit dem Copper am Ende des Screens 
einen Interrupt erzeugen und dann Umschalten oder während des 
Rasterinterrupts. Die beste Methode ist aber auf die letzte Zeile oder 
höher zu warten. Dieses bringt einen enormen Zeitgewinn, da nicht 
genau auf eine Zeile gewartet wird. Beim Game-Animator läßt sich 
dieses mit dem Animationsspeed einstellen. Bei SLOW wird genau auf 
eine Zeile gewartet und bei FAST ab eine Zeile bis zum Bildanfang. 
Dieses bringt bei einer Bildhöhe von 200 Zeilen einen Zeitgewinn 
von ca. 70 Rasterzeilen. 


Mit der Routine WaitRasterZeile () kann man auf eine bestimmte 
Rasterzeile oder höher warten. Dazu übergibt man im Datenregister 
D7 die Zeilennummer (0 bis 313) und ruft die Funtkion auf. Jetzt 
wird solange gewartet, bis der Rasterstrahl die Zeile erreicht oder 
schon passiert hat. Die letzte Zeile eines Bildes errechnet sich dafür 
wie folgt: 


Letzte Zeile = Bildhöhe + 43 
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Hier nun das kurze Listing der Funktion WaitRasterZeile: 


;-- Auf WaitRasterZeile X warten oder höher 
;- D7 = WaitRasterZeile (0 bis 313 Pal) 
WaitRasterZeile: 


lea $dff004 ,a6 
Wrz_ loop]: 

move.b 2(a6),d6 ; RasterZeile lesen 
Wrz_loop2: 

cmp.b 2(a6),d6 ; eine RasterZeile warten 


beq.b Wrz_loop2 
move.l (a6),d6 


Isr.| #8,d6 

and.w #$01ff,d6 

cmp.w d7,d6 ; Rasterzeile > = Zeile ? 
bls.b Wrz loop] ; bne, wenn SlowSpeed 


rts 


10.4 Playfield-Demos 


Bis jetzt haben wir alle Screenmodis beschrieben, aber noch keinen 
selbst erzeugt. Deswegen werden wir jetzt einen eigenen Lo-Res 
Screen über die Hardware programmieren. Auf der beiliegenden 
Diskette befindet sich eine Sammlung von Routinen, über die das 
Programmieren der Hardware, speziell für Spiele, zum Kinderspiel 
wird. Eine Beschreibung der Routinen und des Game-Animators ist 
ebenfalls auf der Diskette. 
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10.4.1 normales Playfield (Lo-Res) 


Tr a Tr re ee ee ee ee ee 


j--- erzeugt einen LoRes-Screen 
i--- 320 x 256, Tiefe = 5 (32 Farben) 


move.| 
move.l 
move. 
jsr 

move.l 


move.| 
move.l 
move.l 
move.l 
move.| 
move.l 
move.| 
move.l 
move.| 
move.l 
moveq 
move.w 
lea 
move.l 
move.l 


4,a6 
gfxname,al 
#0,d0 
-552(a6) 
dO,gfxbase 
Ende 


4,a6 
#((320/8)*256*5),dO 
#$10003,d1 

-198(a6) 
dO,DisplayBasis 

Ende 


4,26 

#104,d0 
#$10003,d1 
-198(a6) 
dO,CopperList 
Ende 


dO,a0 
#%008e2b81,0(a0) 
#%00902bc1,4(a0) 
#%00920038,8(a0) 
#%009400d0, 12(a0) 
#$01080000, 16(a0) 
#$010a0000,20(a0) 
#%01005000,24(a0) 
#01020000,28(a0) 
#%01040023,32(a0) 
#7,d2 

#$00e0,d1 

36(a0),al 
DisplayBasis,dO 
#((320/8)*256),d3 


; OpenLib () 


; Bitplanegröße 
; Chip + Public 
; AllocMem () 


; Länge von Copperliste 
; Chip + Public 


; AO 


= Copperliste 


; DIWSTRT 
; DIWSTOP 
‚ DDFSTRT 
;‚ DDFSTOP 
; BPLIMOD 
; BPL2MOD 
; BPLCONO 
; BPLCONI 
; BPLCON2 


DZ 
‚DI 
;Al 
; DO 
:D3 
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= max. Tiefe-1 (8) 
BPLIPTH 
Copperpuffer 
Bitmapadresse 
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LOOPp: 
move.w dl,(al)+ ; BPLXPTH eintragen 
swap dO ; Hi-Word der Bitplane 
move.w dO,(al)+ 
addq.w #2,d1 
move.w di,(al)+ ; BPLxPTL eintragen 
swap dO 
move.w dO,(al)+ ; Lo-Word der Bitplane 
addq.w #2,d1 
add.l d3,dO ; nächste Bitplane 
dbra d2,Loop 
move.| #%fffffffe,(a1) ; Ende der Copperliste 
move.l 4,36 
jsr -132(a6) ; Forbid () 
sub.l al,al ; View ausschalten 
move.l gfxbase,a6 
jsr -222(a6) ; LoadView () 
jsr -270(a6) ; WaitTOF () 
jsr -270(a6) ; WaitTOF () 
move.|l KCopperList,dO 
move.l dO,$dff080 ; COPILC 
move.w #0,$dff088 ;‚ eigene Copperliste starten 
move.| DisplayBasis,a0 
move.| #-1,(a0) ; Pixel zeichnen 
Waait: 
btst #10,$dff016 
bne Wait 
move.|l 4,36 
jsr -138(a6) ; Permit () 
move.|l gfxbase,a6 
move.|l 34(a6),al ; Active View 
jsr -222(a6) ; LoadView () 
jsr -270(a6) ; WaitTOF () 
jsr -270(a6) ; WaitTOF () 
move.l 38(a6),$dff080 ‚ alte Copperliste 
move.w #0,$dff088 ; starten 
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Ende: 
move.| 
beq 
move.l 


jsr 

Ende _O: 
move.| 
beq 
move.| 
move.| 
move.| 


jsr 
Ende _1: 
move.| 
beq 
move.l 
move.| 
move.l 


jsr 
Ende_2: 
rts 


Copperlist: 


DisplayBasis: 


gfxname: 
even 
gfxbase: 


itel 1 


gfxbase,dO 

Ende _O 

dO,al 

-414(a6) ; CloseLib () 


DisplayBasis,dO 

Ende _1 

dO,al 

#((320/8)*256*5),dO ; Bitplanegröße 
4,36 

-210(a6) ; FreeMem () 


CopperList,dO 

Ende _2 

d0,al 

#104,d0 

4,a6 

-210(a6) ; FreeMem () 


dc.1 0 
dc.| 0 
dc.b "graphics.library",O 
dc.1 0 


10.4.2 Scrolling 


Wie bereits kurz erwähnt wurde, kann man mit den Registern 
BPLxMOD (Modulo) und BPLCONI (Scrollwert) den Amiga-Screen 
kinderleicht in alle Richtungen butterweich scrollen. Mit dieser 
Methode sind die Ausmaße aber auf eine bestimmte Breite und Höhe 
begrenzt. Zudem verbraucht sie sehr viel Speicher. Deswegen werde 
ich hier die wohl effektivste Methode, die Kastentechnik, vorstellen, 
die auch vom Game-Animator benutzt wird und von den meisten 


Spielen. 
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Bei diesem Prinzip teilt man sich sein Spielfeld, von fast beliebiger 
Größe, in gleichgroße Quadrate bzw. Rechtecke ein. Beim Game- 
Animator können diese in den Ausmaßen von 16 x 16 bis 64 x 64 
gewählt werden. 


Nehmen wir mal an, wir verwenden Quadrate von 16 x 16 Pixel und 
davon 100 in einer Reihe nebeneinander und 50 übereinander. 
Damit hätten wir eine theoretische Spielflächke von 100 x 50 
Quadraten oder in Pixel (100 x 16) x (50 x 16) = 1600 x 800. 
Würden wir jetzt für diese Ausmaße einen Screen in 16 Farben 
erzeugen, wäre der Speicher schnell an seine Grenzen angelangt 
(1600/8 x 800 x 4 = 640000 Bytes). Für ein Spiel brauchen wir 
dann auch noch das Double-Buffering, was den Speicherbedarf noch 
auf das Doppelte steigert. 


Deswegen erzeugen wir einen Screen von 320 + 1 Rechteck Breite 
und beliebige Höhe + 1 Rechteck. Dieses eine Rechteck brauchen 
wir deshalb, weil wenn wir in eine Richtung scrollen, nichts auf der 
anderen Bildschirmseite nachscrollen würde. Haben wir dann um ein 
Rechteck in eine Richtung gescrollt, so setzen wir die 
Bildschirmadresse wieder auf den Anfang der Bitmaps und berechnen 
unseren Rechteckpuffer so, daß wir um ein Rechteck auf der 
Spielfläche weiter scrollen. 


Damit das Ganze auch reibungslos abläuft, müssen die Rechtecke in 
einem ganz bestimmten Format im Speicher vorliegen. Bleiben wir 
mal bei unseren Beispiel von 100 x 50 Rechtecken (16 x 16 Pixel), 
einer tatsächlichen Bildbreite von 320 und -höhe von 160 Pixel und 
wir verwenden für unsere Spielfläche 40 verschiedene Rechtecke. 


Als erstes legen wir alle 40 Rechtecke hintereinander im Speicher ab, 
wodurch jedes seine feste Adresse zugeteilt bekommt. Als nächstes 
legen wir einen Puffer von 100 x 50 x 4 Bytes Länge an. In diesem 
Puffer werden die Anfangsadressen der Rechtecke abgelegt, welche 
auf der Spielfläche erscheinen sollen. Die Adressen werden dabei 
nach einem ganz bestimmten Prinzip abgelegt und zwar enthalten 
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die ersten vier Bytes die Adresse des Rechtecks, welches obenlinks auf 
der Spielfläche erscheinen soll und die zweiten vier Bytes die Adresse 
des darunterliegeneden Rechtecks usw., bis alle Adressen einer Spalte 
abgelegt sind, dann folgen die Adressen der zweiten Spalte usw., bis 
alle Spalten durch sind. Das hat den Vorteil, daß wir ein Rechteck so 
oft wie wir wollen benutzen können, da wir die Quelleadresse kennen 
und die Zieladresse aus der Pufferposition gebildet wird. Dabei ist zu 
beachten, daß eine Screenhöhe aber nur 160/16 =10 Rechtecke 
darstellen kann, die restlichen 50 - 10 =40 Rechtecke müssen immer 
übersprungen und dürfen nicht geblittet werden. Dieses könnte zu 
einem Guru führen. Dasselbe gilt für die Bildbreite (siehe Bild 10.c). 


Bild10.c 


Rechtecke (i6 x 16) 


sichtbarer Screen 











oe [oo || 22 122 [22 [22 [4 [ca [ca [ea [64 


spielfläche; 
Rechteckpuffer, 
welcher die 
Adressen der 
Rechtecke ent- 
hält, welche 

an der jeweiligen 
Position er- 
scheinen soll, 


dressen der 


23 
es 32 64 PRechteckgraf iken 


‚Sa: 


Alle Funktionen für das übergroße Scrolling (Kastentechnik), finden 
Sie in den Beschreibungen zu den Animator-Routinen auf der beilie- 
genden Diskette. 
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11. Der Blitter 


Der Blitter ist Teil eines Coprozessors im Amiga und eine Abkürzung 
für "Block-Image-Transferer", was soviel heißt wie Grafikblockver- 
schieber. 


Mit dem Blitter ist es möglich Datenblöcke oder Linien blitzschnell zu 
verschieben bzw. zu zeichnen. Das "blitzschnell" ist auch relativ, denn 
ein 68030er oder 60040er Prozessor würde diese Aufgaben schon 
schneller erledigen. Da die meisten Amiga-User aber einen 
"normalen" 68000er Amiga Ihr eigen nennen, hält der Blitter auch 
was er verspricht. Denn es ist nicht nur einfaches Verschieben oder 
Zeichnen möglich, man kann auch bis zu drei verschiedene Quellen 
beliebig miteinander verknüpfen, Masken setzen und Bereiche 
scrollen. 


11.1 Eine Blitteroperation starten 


So, jetzt kennen wir wohl die Vorteile des Blitters, aber wie 
programmieren wir diese? Dafür fehlen uns noch einige Hintergrund- 
informationen. 


Als erstes wäre da der Blittermodus. Wir können entweder nur 
Datenblöcke bearbeiten oder Linien zeichnen. Es können auch immer 
nur rechteckige Datenbereiche bearbeitet werden. Das heißt, daß die 
Daten in Spalten und Zeilen aufgeteilt werden (Bitmap-Prinzip) und 
auf Wordgrenzen (gerade Adresse) liegen müssen. Möchte man 
gezielte Bitmanipulationen durchführen, so kann man die Quelle A 
mit einer Maske versehen und den Inhalt der Quellen A und B bis zu 
16 Pixel nach rechts scrollen. 
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Folgende Schritte sind notwendig, um eine Blitteroperation zu 
starten: 


- Blittermodus wählen 
- Auswahl der Quellen (bis zu drei) und des Ziels D 
- Logische Verknüpfung der Quellen wählen 
- Definition der fehlenden Parameter 
(Maske, Scrolling, Modulo, Transferrichtung) 
- Blittertenster Festlegen und Blitter starten 


Als erstes geben wir an, wie groß der Bereich sein soll, den wir mit 
dem Blitter bearbeiten möchten. Da der Blitter bitmaporientiert 
arbeitet, also seinen Bereich in Zeilen und Spalten einteilt, müssen 
wir diesen Wert auch so definieren. Die Breite wird in Words (1 
Word = zwei Bytes) und die Höhe in Zeilen festgelegt. 


Register: BLTSIZE ($DFFO58) nur schreiben 
Bit: 15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00 
H9 H8 H7 H6 H5 H4 H3 H2 H1 HO W5 WA W3 W2 Wı WO 


H9 bis HB 

Höhe des Blitterfensters in Zeilen. Es sind Werte von 1 bis 1024 
möglich. Die Höhe 1024 wird durch Setzen von H9 bis HO gleich 
Null erreicht. 


W5 bis WO 

Breite des Blitterfensters in Words (16 Bit-Schritten). Es sind Werte 
von 1 bis 64 möglich (64 Words x 16 Pixel = 1024 Pixelbreite). Die 
maximale Breite von 64 Words erreicht man durch setzen von W5 bis 
WO gleich Null. 
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Der Wert für das BLTSIZE-Register läßt sich mit folgender Formel 
berechnen: 


BLTSIZE =(Höhe & $3FH * 64 + (Breite & $3H) 


Als Assemblerlisting: 


;-- DO = Anzahl Zeilen (Höhe), DI = Anzahl Words (Breite) --- 


and.w #$3FF,dO ‚ Höhstwert = Null 
Isl.w #6,d0 ‚ Höhe * 64 

and.w #$3F,d1 ‚ Höhstwert = Null 
add.w d1,dO ‚Höhe + Breite = SIZE 


;—- DO =\Wert für BLTSIZE ---- 


Hat man diesen ersten wichtigsten Wert definiert, auf den alle 
anderen aufbauen, so darf dieser erst als letztes in das BLTSIZE- 
Register geschrieben werden. Denn mit dem Beschreiben des 
BLTSIZE-Registers wird die Blitteroperation gestartet. 


Diese Registerbelegung bezieht sich auf alle Amigas. Ab ECS-Amigas 
sind zwei neue Register hinzugekommen, mit denen sich jetzt eine 
Blittergröße von 32768 x 32768 Pixel ermöglichen läßt. 


ECS-Register: BLTSIZV ($DFFOS5C) nur schreiben 
Bit: 15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00 
00 H14 H13 H12 H11 H10 H9 H8 H7 H6 H5 H4 H3 H2 H1 HO 


414 bis HO [Vertikale Größe) 
Höhe des Blitterfensters in Zeilen. Es sind Werte von 1 bis 32768 


möglich, Die Höhe 32768 wird durch Setzen von H14 bis HO gleich 
Null erreicht. 
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ECS-Register: BLTSIZH ($DFFO5E) nur schreiben 
Bit: 15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00 
00 00 00 00 00 W10 W9 W8 W7 W6 W5 WA W3 W2 Wı WO 


W10 bis WO (Horizomiale Größe und Blitterstart) 


Breite des Blitterfensters in Words. Es sind Werte von 1 bis 2048 
möglich. Die Breite 2048 Words wird durch setzen von W10 bis WO 
gleich Null erreicht. 


Möchte man den Blitter über diese Register starten, so wird das alte 
BLTSIZE-Register ignoriert und zuerst das BLTSIZV beschrieben und 
danach das BLTSIZH-Register, wodurch die Blitteroperation gestartet 
wird. Natürlich kann man hier die Register sofort beschreiben (ohne 
Formel). 


Als nächstes müssen die Modulo-Register des Blitters beschrieben 
werden. Denn es kann ja auch zum Beispiel sein, daß wir ein Teil aus 
einem Screen mit dem Blitter herauskopieren möchten. Dann hätte 
das Ziel einen Modulo-Wert von Null und die Quelle einen Modulo 
von: 


Quelle = (Screenpixelbreite/16) - (Blittenpixeibreite/16) * 2 
Allgemein können die Modulo wie folgt berechnet werden: 


Quelle = [uellpixeibreite/16) - (Blitterpixelbreite/16) * 2 
Ziel = (Zielpixelbreite/16) - (Blitterpixeibreite/16) * 2 


Es können auch negative Modulo-Werte angegeben werden. Damit 
lassen sich zum Beispiel Spiegeleffekte erzeugen. Dazu nimmt man 
die Endadresse einer Grafik und den doppelten negativen Modulo- 
wert. 
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Modulo-Register: (nur schreiben) 
BLTCMOD = $DFF060 => Modulo für Quelle C 


BLTBMOD = $DFF062 => Modulo für Quelle B 
BLTAMOD = $DFF064 => Modulo für Quelle A 
BLTDMOD = $DFF066 => Modulo für Ziel D 


Damit der Blitter erkennt, wo die Quellen bzw. das Ziel beginnt, 
müssen wir die Startadressen dieser noch in folgenden Registern 
festlegen. 


BLTxPT-Register: (nur schreiben) 
BLTCPT = $DFF048 => Anfangsadresse für Quelle C (Longword) 


BLTBPT = $DFFO4C => Anfangsadresse für Quelle B (Longword) 
BLTAPT = $DFFO50 => Anfangsadresse für Quelle A (Longword) 
BLTDPT = $DFFO54 => Anfangsadresse für Ziel D (Longword) 


Jetzt kommen wir zu den wohl wichtigsten und interressantesten 
Parametern - den Verknüpfungen der Quellen. 


Der Amiga bietet die Möglichkeit maximal drei Quellen beliebig 
miteinander zu verknüpfen und das Ergebnis an eine beliebige 
Zieladresse zu schreiben. Die Verknüpfungen werden bitweise 
vorgenommen. Das heißt, daß das erste Bit von Quelle A mit dem 
ersten Bit von Quelle B und dem ersten Bit von Quelle C zu dem 
Zielbit D verknüpft werden usw.. Die Verknüpfungen laufen nach der 
"Booleschen Algebra" ab, jedoch sind keine Kenntnisse darüber 
notwendig, um diesen Teil zu verstehen. Ich erwähne diesen Begriff 
nur, damit Sie ihn einmal gehört haben. Doch jetzt zum 
Verknüpfungsprinzip: 


Da einem drei Quellen zur Verfügung stehen, wobei auch immer alle 
drei verwendet werden müssen, besitzt man einen Wertebereich von 
O bis 15 bzw. 16 verschiedene Kombinationsreihen. Jede dieser Reihe 
kann mit einer anderen kombiniert werden, wodurch maximal 256 
(16 x 16) verschiedene Kombinationen entstehen (siehe Tabelle). 
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Tabelle der 8 Kombinationsreihen (Minterme): 


LFrx ABC => D(x=0 oder x=|]) 
LFO 000 X 


LFI 90913 X 
LFZ2 O10 x 
LFB3 011 X 
LF4 100 x 
LF5 101 X 
LF6 110 x 
EZ TI. x 


Sie müssen jetzt nur alle Reihen durchgehen und entweder zu Null 
oder Eins setzten, was abhängig von Ihrer Verknüpfung ist. Jede 
dieser Reihen, wird als Minterm bezeichnet. 


Zum Beispiel wollen Sie Daten der Quelle A mit Daten der Quelle B 
ODER-Verknüpfen. Anders ausgedrückt, muß das Ziel D immer dann 


zu Eins werden, wenn entweder Quelle A oder B Eins ist, wenn beide 
Quellen Null sind, dann soll auch das Ziel D Null werden. 


Daraus resultiert folgende Tabelle (-ODER): 


Lrx ABC =>D (x=0 oder x=1) 


LFO 000 0 (A&B= 0) 
LFI 001 0 (A&B= 0) 
LF2 010 ı1ßB=1) 
LF3 011 ıßB=1) 
LF4 100 1 (A=ı) 
LF5 101 1(A= |) 
LF6 110 1 (A&B= |) 
LF7 111 1 (A&B= |) 


=> Ux = UZ UF, UA, LP3, LF6, LF/ 
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Das Bit von Quelle C hat für unser Beispiel keine Bedeutung (ist egal) 
und kann ausgeschlossen werden. 


Für eine UND-Verknüpfung der Quellen A, B und C sieht die Tabelle 
folgendermaßen aus: 


LFrx ABC => D(x=0 oder x=1) 
LFO O0OO 
LFI 001 
LF2 
LF3 
LF4 
LF5 
LF6 
LF7 


oO 


0 
0 
0 
0 
0 
0 
1 (A&6B&EC= 1) 


Das Ziel D wird nur dann Eins, wenn alle drei Quellen eine Eins 
besitzen. 


=> Ur = W/ 


Die so gewonnenen LFx-Minterme können im BLTCONO-Register 
entsprechend gesetzt werden. Außerdem enthält das Register noch 
ein paar andere Bits. 


Register: BLTCONO ($DFFO40) nur schreiben 


Bit _Name_ Beschreibung 
15 ASH3 ASH3 bis ASHO enthalten den Scrollwert, 


14 ASH2 um den die Quelldaten A vor der Ver- 
13 ASHI knüpfung nach rechtsgescrollt werden 
12 ASHO soll (Scrollwert O bis 15). 

11. USEA Ein- Ausschalter für Quelle A 

10 USEB Ein- Ausschalter für Quelle B 
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9 USEC Ein- Ausschalter für Quelle C 

8 USED Ein- Ausschalter für Ziel D 

7 __LF7 ab hier stehen die 

6 _LF6 möglichen Minterme (LF7 bis LFO) 

5  LF5 Soll zum Beispiel der LF7-Minterm 

4 __LF4 gesetzt werden, so setzt man einfach 
3  LF3 das Bit 7 auf eins. 

2 iR 

1 LFI 

0  LFO 


Für die Verknüpfungen müssen alle Quellen miteinbezogen werden, 
es brauchen aber nicht alle eingeschaltet sein. Möchte man zum 
Beispiel eine Collision zwischen zwei Objekten feststellen, so braucht 
in das Ziel D nichts hineingeschrieben werden (USED = O0). Für 
einige Operationen ist es notwendig ein oder zwei Quellen um ein 
paar Pixel vor der Verknüpfung zu verschieben. Dabei werden die 
letzten Bits herausgeschoben und die ersten Bits mit Nullen gefüllt. 
Alle anderen Bits werden von einer Reihe in die nächste verschoben. 


Ab den ECS-Amigas können die Minterme seperat in einem neuen 
Register gesetzt werden, was die Geschwindigkeit noch weiter erhöht, 
da die oberen acht Bits im Prinzip immer gleich bleiben. 


ECS-Register: BLTCONOL ($DFFO5A) nur schreiben 
Bit: 15 14 13 12 11 130 9 08 07 6% 05 994 93 m 91 90 
00 00 00 00 00 00 00 00 LF7 LF6 LF5 LF4 LF3 LF2 LFI LFO 


Es ist nicht immer notwendig alle drei Quellen zu verwenden. 
Deswegen sollte man sich vorher genau überlegen, welche Quellen 
benutzt werden sollen, weil daraus unterschiedliche Geschwindig- 
keiten im Blitterablauf resultieren. 
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Jede Blitteroperation benötigt mindestens vier Taktzyklen plus null bis 
vier Zyklen in Abhängigkeit was für Quellen benutzt werden (siehe 
Tabelle). 

Blittergeschwindigkeit (Basis = vier Zyklen) 


Quelle zusätzliche Zyklen 


B zwei 

C+D zwei 
Beispiele: 
AundD = vier Taktzyklen (minimum) 
CundD = sechs Taktzyklen 
BundD = sechs Taktzyklen 
A, Cund D = sechs Taktzyklen 
B, Cund D = acht Taktzyklen (maximum) 


Die Zyklen beziehen sich auf ein Word bzw. im Linienmodus auf 
einen Pixel, wodurch wir zu folgender Formel kommen: 


Blittergesamtzeit für PAL-Amigas in microsekunden: 
Zeit = Takteyklen x Blitterhöhe x Blitterworolbreite / 7.16 


Blittergesamtzeit für NTSC-Amigas in microsekunden: 


Zeit = Takteyklen x Blitterhöhe x Blitterwordlbreite / 7.09 


Zum Beispiel: 
Quellen A, B und D 
Blitterbreite = drei Words, Blitterhöhe = 10 


Zeit=6x3x10/7.19 = 25.03 microsekunden (PAL) 
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Jetzt haben wir fast alle Funktionen des Blitters beschrieben - bis auf 
eine, die Maskenfunktion. 


Der Blitter erlaubt das Setzen einer Maske am Anfang einer Zeile und 
am Ende, allerdings nur für die Quelle A. Die Masken sind jeweils ein 
Word groß, also 16 Bits. Jedes Bit in der Maske, das gesetzt ist, wird, 
nur für die Quelle A, zur Verknüpfung herangezogen. Folgendes 
Beispiel: 


ersten zwei Zeilen der Quelle A 
1111000111111000 1111111111111111 1111000000001011 
00111100000001 11 111110000000001 1 0000000001 10011 1 


First Mask Last Mask 
0001111111111111 1111111111111000 
Ergebnis nach dem Maskieren 


0001000111111000 1111111111111111 111100000000 1000 
0001110000000111 111110000000001 1 0000000001 100000 


Die Masken beziehen sich immer auf den Anfang und das Ende einer 
Blitterzeile und werden nicht gescrollt (siehe ASHx). 


Register: BLTAFWM ($DFFO44) (nur schreiben) 
=> Maske für das erste Datenword einer Zeile 


Register: BLTALWM ($DFFO46) (nur schreiben) 
=> Maske für das letzte Datenword einer Zeile 


Das Scrolling für die Quelle A haben wir bereits besprochen (siehe 
BLTCONO). Dieses ist aber auch für die Quelle B vorhanden. Der 
Scrollwert wird im zweiten Blitterkontrollregister abgelegt, das 
folgenden Aufbau hat: 
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Register: BLTCONI ($DFFO42) nur schreiben 


Bit_Name hrei 

15 BSH3 BSH3 bis BSHO enthalten den Scrollwert, 
14 BSH2 um den die Quelldaten B vor der Ver- 
13 BSHI knüpfung nach rechtsgescrollt werden 
12 BSHO soll (Scrollwert O bis 15). 


11 -- unbelegt 

10  ---  unbelegt 

9 --- unbelegt 

8 --  unbelegt 

7 DOFF Ausgabe für Ziel D sperren (nur ab ECS) 
6 --- unbelegt 

5 -—- unbelegt 

4 EFE Exclusive Fill Enable (Flächenfüllmodus) 
3 IFE Inclusive Fill Enable (Flächenfüllmodus) 
2 FC  Fill Carry In (Flächenfüllmodus) 

1 DESC DESC = 1, schaltet auf Descending Modus 
O0 LINE LINE = 1, Blitterlinienmodus einschalten 


Mit dem DESC-Bit kann festgelegt werden, ob der Blitter seine 
Operation Vorwärts (DESC=0), d. h. mit dem ersten Datenword 
beginnt und fortlaufend bis zum letzten fortführt bzw. mit dem letzen 
Datenword beginnt (DESC=1) und bis zum ersten durchführt. 


Das LINE-Bit schaltet den Blitter vom einfachen Datenkopieren und 
verknüpfen auf das Zeichnen von Linien um (LINE=1). 


Die Bits EFE, IFE und FCI sind für den Flächenfüllmodus zuständig 
und müssen für den Normalbetrieb auf Null gesetzt werden. 
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Wie läuft nun ein normaler Blittervorgang ab? 


Nachdem wir die Adressen der Kanäle, die Masken, die Modulos und 
die Kontrollregister entsprechend versorgt haben, starten wir den 
Blittervorgang durch Beschreiben des BLTSIZE-Registers. Jetzt wird 
jeweils ein Datenword jeder Quelle gelesen, entsprechend Verknüpft 
und in der Zieladresse abgelegt. Danach werden die Adressen um ein 
Word erhöht und der Vorgang erneut gestartet, bis eine Blitterzeile 
durch ist. Am Ende jeder Zeile werden die Modulowerte zu den 
Adressen addiert und mit der Blitteroperation fortgefahren, bis alle 
Zeilen bearbeitet wurden. 


Die Daten der Quellen und des Zieless D werden nicht direkt im 
Speicher bearbeitet, sondern vorher in dazugehörige Register 
zwischengespeichert. 


Register _ Adresse Funkti 

BLTDDAT $DFFOOO Zwischenpuffer für Zieldaten D 
BLTCDAT $DFFO7O Zwischenpuffer für Quelldaten C 
BLTBDAT $DFFO72 Zwischenpuffer für Quelldaten B 
BLTADAT $DFFO74 Zwischenpuffer für Quelldaten A 


Der DMA-Controller liest die Words der Quellen aus dem Speicher 
und schreibt sie in obige Register. Danach werden sie miteinander 
verknüpft und das Ergebnis enthält das BLTDDAT-Register. Jetzt über- 
trägt der DMA-Controller das Ergebnis vom BLTDDAT-Register wieder 
in das CHIP-RAM. 


Den Blitter--DMA kann man mit den BLTEN-Bit (Bit 6) des DMACON- 
Registers für alle Kanäle einschalten (siehe Kapitel 1.9). Dieses 
Register hat aber noch ein paar weitere Bits, die für den Blitter 
interresant sind. 
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Das BLTPRI-Bit (Bit 10) im DMACON-Register: 


Wenn dieses Bit auf Eins ist, hat der Blitter absolute Priorität vor dem 
Prozessor auf das CHIP- RAM. 


Das BBUSY-Bit (Bit 14) im DMACON.:Register: 


Ist dieses Bit auf Eins, befindet sich der Blitter gerade in Funktion. 


Das BZERO-Bit (Bit 13) im DMACON-Register: 


Dieses Bit ist Eins, wenn alle Ergebnis-Bits Null waren, d. h. wenn 
keine gewählte Verknüpfung eine Eins lieferte. Mit Hilfe dieses Bits 
kann man eine Kollisionsabfrage programmieren. 


Flächenfüllen mit dem Blitter: 


Mit dem Blitter kann man blitzschnell beliebige Bereiche einer Grafik 
mit Pixel füllen. Das einzige, was er dazu braucht, sind Begrenzungs- 
bits. Diese sind notwendig, damit er weis, wann mit dem Füllen 
begonnen und wann es wieder beendet werden soll. Dafür verwendet 
der Blitter ein ganz einfaches System. 


Als erstes wird das Blitterfenster, wie gewohnt festgelgt. Danach 
beginnt der Blitter, von der rechten Seite her, die Bits einer Zeile zu 
lesen. Wenn er auf eine Eins stößt wird ab dem nächsten Bit mit dem 
Füllen begonnen und das FCI-Bit auf 1 gesetzt. Jetzt werden solange 
Einsen gesetzt, bis der Blitter wieder auf eine Eins stößt, wodurch das 
Füllen unterbrochen wird und das FCI-Bit wieder zu Null wird. Dieses 
wird solange fortgeführt, bis eine Zeile durch ist und mit der 
nächsten begonnen werden kann. Für das fehlerfreie Füllen ist darauf 
zu achten, daß die Begrenzungen richtig gesetzt werden. 
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Beispiel eines fehlerfreien Füllvorgangs: 


Vorher (Begrenzungen) Nachher 

0000001010000000 000000 1 110000000 
000001000 1000000 000001 1111000000 
0000 100000100000 00001 11111100000 
0001010001010000 000 1110001 110000 
001000000000 11000 O011111111111000 
000001000 1000000 000001 1111000000 

Beispiel eines nicht fehlerfreien Füllvorgangs: 

Vorher (Begrenzungen) Nachher 

0000001 110000000 1111111110000000 
000001 1011000000 1111111111000000 
0000 110001100000 0000 110001100000 
0001010001010000 0001 110001110000 
001000000000 1000 0011111111111000 
0000010001000000 000001 1111000000 


Den Startwert des FCI-Bits kann man zu Beginn im BLTCON 1-Register 
mit dem Bit 2 festlegen. Ist es auf Null, so wird wie oben 
beschrieben vorgegangen. Ist es auf Eins, so beginnt der Blitter vom 
rechten Rand her zu füllen, bis er auf das erste gesetzte Bit einer 
Zeile stößt usw. Den gesamten Füllvorgang aktiviert man, wenn man 
das IFE-Bit (Bit 3) auf 1 setzt. 


Beim IFE-Modus bleiben die Begrenzungsbits im Ergebnis erhalten, 
wodurch nur eine minimale Fläche von zwei Pixeln möglich ist. Für 
noch schmalere Flächen existiert der EFE-Modus. Dieser funktioniert 
genauso wie der andere, aber das Begrenzungsbit am linken Rand 
einer gefüllten Fläche wird nicht mit übernommen. 
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Um den Füllvorgang zu starten, werden genau wie vorher alle 
nötigen Parameter eingestellt und zusätzlich der gewünschte 
Füllmodus ausgewählt. Jetzt wird der Blitter gestartet. Nachdem der 
Blitter seine Quellen verknüpft und das Ergebnis ins Zieldatenregister 
geschrieben hat, wird dieses nach dem entsprechenden Füll-modus 
gefüllt. 


Das zusätzliche Füllen schränkt die Geschwindigkeit des Blitters nicht 
ein. Er ist in der Lage eine Fläche von 16 Millionen Pixel in der 
Sekunde zu füllen. 


Linienziehen mit dem Blitter: 


Der letzte Modus, in dem der Blitter betrieben werden kann, ist der 
Linienmodus. Hier ist der Blitter in der Lage Linien, mit einem 16-Bit 
Muster, in einer maximalen Länge von 1024 Pixel zu zeichnen (ab 
ECS = 32768 Pixel). 


Eine Linie wird bekanntlich durch zwei Punkte begrenzt und über 
diese können alle notwendigen Parameter, wie z. B. Steigung und 
Länge, welche für den Blitter erforderlich sind, berechnet werden. 


Als erstes muß der Oktant bestimmt werden, durch dem die Linie 
verläuft. Dazu wird ein Koordinatenkreuz in acht Teile aufgeteilt. 
Jeder dieser Teile stellt einen Oktanten da, die bestimmten Be- 
grenzungen unterliegen. Über den Start- und Endpunkt kann dann 
der Oktant bestimmt werden (siehe Bild 11.a). 
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“1>=X2 
Yi<=Y2 
dx>=dY 


(3) [7] 


x1>=X2 
Yı1>=Y2 
dX>=dY 


(4) [5] 


“1>=X2 
Yı<=Y2z 
dX<=dY 


(2) [3] 





“1>=X2 
vYrıi>=YT2 
dX<=dY 


(5) [2] 


je Anfangspunkt 


B- EndPunkt 


[1 
0) 


“1<=X2 
yı<=Y2 
dX<=dY 
(1)L1J 
x1<=X2 
yYi1<=Y2 
dx>=dY 
(B)L6] 
Bıxı,yı) 
x1<=X2 
Yıi>=-Y2 
dx>=dY 
(7)L4] 


Xi <=X2 
Yıi>=Y2 
X<=dYV 


(6) Ie] 


Mert für SW, SUL, AL 
Oktantnummer 


Bild 11.a 
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Zum Beispiel soll eine Linie von Punkt A (20,-10) nach Punkt B (80,- 
30) gezeichnet werden. Daraus resultiert folgender Oktant: 


20 < 30 == Al < 
-10 > -30 => Yi>Y2 
(X2-X1) = (80-20) = 60 => IX 
(Y2-Y1) = (30 - -10) = -20 ° => dY 
60 > -20 => dA>W 


=> Oktant 7: (X1 <= X), V1 >= Y2), (X >= dY) 


Den Oktanten kann man in Assembler mit drei Vergleichen ermitteln. 
Dazu nimmt man die ersten drei Bits eines freien Datenregisters. Das 
Bit 2 stellt das Ergebnis des X1/X2-Vergleiches da. Wenn X2 >= X] 
dann ist Bit 2 = O0, wenn X2 <= X1 dann Bit 2 = 1. Das Bit 1 
enthält das Ergebnis des Y1/Y2-Vergleiches und das Bit O des dX/dY- 
Vergleiches. Dabei entsteht ein Wertebereich von O bis 7, mit dem 
man auf eine Tabelle zugreifen kann, welche den dazugehörigen 
SUD, SUL, AUI-Wert enthält. 


Hier ein kleines Beispielassemblerlisting zum Bestimmen des Oktan- 
ten: 


—— DO =X1, DI = Y1, D2 = X2, D3 =Y2 — 


moveqg #0,d5 ‚D5 =0 
sub.w dO,d2 ıX2-X1 
bp! deltaX_pos ; wenn X2 >= X], dann deltaX_pos 
neg.w d2 ;D2 = «X 
addq.w #4,d5 ‚Bt2=1 
deltaX_pos: 
sub.w d1,d3 ; Y2-Y1 
bp! deltaY_pos ; wenn Y2 >= Y1, dann deltaY_pos 
neg.w d3 ; D3 = dY 
adda.w #2,d5 ;Btie] 


Seite 446 


Der _Blitter Kapitel 11 


deltaY_pos: 
cmp.w d2,d3 ‚dY >=? 
bp! delta_pos ; wenn ja, dann delta_pos 
addq.w #1,d5 ;BtO= 1 
exg.w d2,d3 ;D2 = dk, D3 = dG 
delta_pos: 


lea octantab,a5 
move.b (a5,d5.w),‚d5 ;D5 = SUD,SUL,AUL-Wert 
rts 


octantab: dc.b 1,6,0,4,3,7,2,5 


Der Blitter benötigt aber nicht nur den Octantencode, sondern auch 
den Steigungswert der Linie. Der muß natürlich wieder blittergerecht 
vorliegen. 


Als erstes bildet man den dX (X2-X1) und den dY (Y2-Y1) Wert und 
vergleicht diese. Das größere Delta von beiden ist dann das 
DeltaGroß, kurz dG und das kleinere das DeltaKlein, kurz dK. Für die 
Steigung müssen jetzt aus den dG und dK drei Werte berechnet 
werden. 


1. Wert = 2x dK 
2. Wert = 2 x dK - dG 
3. Wert = 2xdK-2xdG 


Wenn (2 x dK < dG) ist, muß noch das SIGN-Bit im BLTCONT!- 
Register auf I gesetzt werden. 


Beim Zeichnen von Linien benutzt der Blitter die selben Register wie 


beim Kopieren von Daten bzw. Füllen von Flächen, allerdings wer- 
den diese teilweise anders belegt und zwar folgendermaßen: 
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Register _Adr. Funktion 


BLTBMOD $DFFO62 
BLTAPTL $DFFO52 
BLTAMOD $DFFO64 
BLTCMOD $DFFO60 


BLTDMOD $DFFO66 
BLTCPT $DFFO48 
BLTDPT $DFFO54 
BLTADAT $DFFO74 
BLTAFWM $DFFO44 
BLTBDAT $DFFO72 
BLTSIZE $DFFO58 


1. Wert für Steigung (2 x dK) 

2. Wert für Steigung (2 x dK - dG) 

3. Wert für Steigung (2 x dK - 2 x dG) 

Breite der Zielbitmap in Bytes, in der die 
Linie gezeichnet werden soll. (Z. B. Screen- 
breite =320 Pixel, Wert = 320/8 = 40 Bytes) 
genau wie BLTCMOD 

Anfangsadresse des ersten Words der Linie. 
genau wie BLTCPT 

hier muß der Wert $8000 eingetragen werden 
hier muß der Wert $FFFF eingetragen werden 
16-Bit Muster für die Linie (normal $FFFF) 
Startet das Zeichnen der Linie. Die Breite 

muß auf 2 gesetzt werden und die Höhe ist 
gleich dem dG (deltaGroß). 


Jetzt fehlt noch die Belegung der Blitterkontrollregister: 


Register: BLTCONO ($DFFO40) nur schreiben 


Bit_ Name Beschreibun 
START3 START3 bis STARTO enthalten die Start- 
START2 position des Bits innerhalb des ersten 
STARTI Datenwords (Wert = X1 and 15). 


USEA= 1 Fürs Linienziehen müssen die Kanäle A, 
USEB=O C und D eingeschaltet werden. 


USEC=] 


15 
14 
13 
12 STARTO 
11 
10 
9 
8 USED=1 


7-0 LFx=$CA Fürs Linienziehen müssen die Minterme LF1, LF3, 
LF6, LF7 = 1 sein. Es sind auch andere möglich. 
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Register: BLTCONI ($DFF042) nur schreiben 


Bit me 

15 Texture3 
14 Texture2 
13 Texture] 
12 TextureO 


7  _DOFF 
6  SIGN 
5 en 

4 SUL 
3  SUD 
2 AUL 
1 SIGN 


O0 LINE 


Zum Abschluß 


hrei 
Scrollwert für das 16 Bit-Muster im 
BLTBDAT-Register (normal = 0) 


unbelegt 

unbelegt 

unbelegt 

unbelegt 

Ausgabe für Ziel D sperren (nur ab ECS) 

wenn 2x dK < dG, dann muß SIGN = 1 sein 
unbelegt 

enthalten den SUL, SUD, AUL Wert des 
entsprechenden Oktanten 


wenn SIGN = 1, dann werden Linien mit 


nur einem Pixel/Zeile gezeichnet. 
LINE = 1, Blitterlinienmodus einschalten 


des Linienmodus folgt noch ein kleines 


Assemblerlisting, das auf einer beliebigen Bitmap eine Linie zeichnet. 
Diese Funktion bezieht sich auf Bitmaps, die zeilenweise im Speicher 
liegen. Eine "normale" Routine für Bitmaps, die bitmapweise im 
Speicher liegen, befindet sich auch auf der Diskette. 


Routine: Drawline und DrawOnePixelLine 
(DO-D4/AO) 
Parameter: DO =StartX-Wert (X1) 


DI = 


D2 
D3 


StartY-Wert (Y1) 
EndX-Wert (X2) 
EndY-Wert (Y2) 
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D4 
AO 


Erklärung: 


Farbregisternummer, aus dem die Farbe für die 
Linie genommen werden soll. 
Bitmap-Struktur 


Die DrawLine-Funktion zeichnet eine Linie, in einer bestimmten Farbe 
auf eine Bitmap. Die DrawOnePixelLine-Funktion macht genau das 
selbe, nur mit einem Pixel/Zeile. 


-- Zeichnet eine Linie in beliebiger Farbe - 
- (DO=X1,D1=Y1,D2=X2,D3=Y2,D4=Color,AD=Bitmap) -- 


eaaies 


cmp.w dO,d2 


bne di _O 


cmp.w d1,d3 


bne di O 
rts 

di 0: 
neg.w d] 
neg.w d3 


moveq #0,d5 
sub.w dO,d2 


bpl di 1 
neg.w d2 


addg.w #4,d5 


di 1: 


 sub.w d1,d3 


bpl di_2 
neg.w d3 


adda.w #2,d5 


di 2: 


cmp.w d2,d3 


bpl di_3 


addq.w #1,d5 


exg d2,d3 


X? 
:Yyj = YZ? 
; Ende, wenn Start = End 


; YI negieren 
; Y2 negieren 


dX 


; dX jetzt positiv 


“dY 


; delta 
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di 3: 
lea OctanTab,a5 
move.b (a5,d5.w),d5 ; Octantwert 
lea $dff000,a6 ; Chipbasis 
move.w #$ffff,$44(a6) ; FirstMask 
move.w #$8000,$74(a6) ; BLTADAT 
add.w d2,d2 
move.w d2,$62(a6) ; Modulo B (2xKdelta) 
sub.w d3,d2 
bp! di_4 
or.w #64,d5 
di 4: 
move.w d2,$52(a6) ; BLTAPTL (2xKdelta-Gdelta) 
sub.w d3,d2 
move.w d2,$64(a6) ; Modulo A (2xKdelta-2xGdelta) 
move.w dO,d2 
and.w #15,d2 
ror.w #4,d2 
or.w #$bca,d2 ; D2 = BLTCONO 
move.w d5,$42(a6) ; BLTCONI 
Isl.w #6,d3 
addq.w #2,d3 :D3 
and.| #$ffff,dO 
Isr.w #4,dO 
add.w dO,dO 
neg.w dI 
mulu (a0),d1 
moveqg #0,d5 
move.b 5(a0),d5 
mulu d5,d1 
add.! d1,dO ; DO 
move.w d5,d1 
mulu (a0),d5 
move.w d5,$60(a6) ; Modulo C 
move.w d5,$66(a6) ; Modulo D 
subg.w #1,d1 ; DI = Anzahl Bitmaps-1 


BLTSIZE 


Bitmapoffset 
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Colorzähler 
Bitmaptable 


moveqg #0,d5 :D5 
lea 8(a0),al ‚Al 


di color loop: 
move.w d2,$40(a6) ; BLTCONO 
move.w #-1,$572(a6) ; Maske 
btst d5,d4 
bne dIi_c2 
move.w #0,$72(a6) 
di c2: 
move.| (al)+,a2 
add.| dO,a2 
move.| a2,$48(a6) 
move.| a2,$54(a6) 
move.w d3,$58(a6) 
di wart: 
btst #14,$2(a6) 
bne d| wart 
addq.w #1,d5 
dbra d1,dI_color_loop 
rts 


octantab: 
°cD 3,29,1:17,13,.29,9, 21 ; Codewertx4 + 1 
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11.2 Blitter-Systemfunktionen 


Wenn wir den Blitter direkt über die Hardware programmieren 
wollen, müssen wir dem System mitteilen, daß kein anderes Pro- 
gramm den Blitter während dieser Zeit einsetzten darf. 


Mit der Funktion "OwnßBlitter ()", die keine Parameter benötigt, 
reservieren wir den Blitter für unseren Zugriff. Danach müssen wir 
noch die Funktion "WaitBlit ()" aufrufen, ebenfalls ohne Parameter. 
Denn es könnte sein, daß gerade noch ein Blittervorgang vom 
System durchgeführt wird. 


Benötigen wir den Blitter nicht mehr, wird der Zugriff dem System 
mit der Funktion "DisOwnBlitter ()" wieder erlaubt. Auch hier sind 
keine Parameter erforderlich. 


Alle drei Funktionen sind in der "graphics.library" enthalten und 
haben folgende Offsets: 


Funkti 
OwnBlitter  -456 Blitter für System sperren 

DisOwnbBlitter -462 Blitter für System freigeben 

WaitBlit -228 Auf Ende der letzten System-Blitteroperation warten 


Beispiel für eine korekte Blitterübernahme: 


;-- Graphics-Library öffnen ---- 


lea gfxname,al ; LibName 
moveq #0,d0 ; Version 
move.| 4,a6 

jsr -552(a6) ; OpenLibrary () 
move.| dO,gfxbase 

beq Ende 
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;--- Blitter für System sperren --- 
move.| gfxbase,a6 
jsr -456(a6) ; OwnbBlitter () 
jsr -228(a6) ; WaitBlit () 


-- hier eigene Blitteroperation über die Hardware starten --- 


me we we un. 
i ı 


-- Blitter für System freigeben --- 
move.| gfxbase,a6 
Jsr -462(a6) ; DisOwnßBlitter () 


;--- Programm beenden --- 


Ende: 

move.| gfxbase,dO 

beq Ende _1 

move.| dO,al 

move.| 4,36 

jsr -414(a6) ; CloseLibrary () 
Ende _1: 

rts 


* 
ı 


gfxbase: dc.lO 
gfxname: dc.b "graphics.library",O 
even 
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12. Sprites 


Sprites sind kleine bewegliche Objekte von 16 Pixel Breite und 
beliebiger Höhe (maximal die Höhe vom Screen), welche überall auf 
dem Screen positioniert werden können. Die Auflösung beträgt 
immer Lo-Res, unabhängig von der Bildschirmauflösung. Ein Sprite 
besitzt immer drei Farben, man kann aber auch zwei Sprites zu einem 
15-Farben-Sprite kombinieren. Der Mauszeiger ist zum Beispiel ein 
Dreifarbensprite. 


Wenn man sich die Informationen so anhört, könnte man denken, 
daß die Sprites die idealen Objekte für Spiele wären, wenn 
unbegrenzt viele vorhanden wären. Und genau hier liegt die 
Einschränkung. Es können nur maximal 8 Dreifarbensprites bzw. 4 
Fünfzehnfarbensprites auf einen Screen gleichzeitig dargestellt 
werden. 


12.1 Spriteaufbau 


Wie bereits kurz erwähnt, besteht ein Sprite aus drei Farben, jedoch 
müssen sich immer zwei aufeinanderfolgende Sprites vier Farbregister 
teilen (ein Farbregister für Transparentfarbe),. Von den 32 
Farbregistern des Amiga werden die Farben für die 8 Sprites aus den 
Register 16 bis 31 entnommen. 


Die Form des Sprites wird zeilenweise beschrieben, ähnlich der des 
Bitmapsprinzip vom Game-Animator (siehe Kapitel 10). Das heißt, 
jede Zeile wird durch zwei Words dargestellt. Jedes Bit des 1. Words 
(Low-Word), bestimmt mit dem entsprechenden Bit des 2. Words 
(High-Word) das Farbregister, aus dem die Farbe für den Punkt 
entnommen werden soll. 
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Beispiel zur hrei iner Spritezeile: 
LowWord (Bit 0) HighWord (Bit 1) 
111000000000000 1 001 1000000000000 
Punkt 1 u. 2 : Bitpaar = O1 

Punkt 3 : Bitpaar = 11 

Punkt 4 : Bitpaar = 10 

Punkt 5 bis 15 : Bitpaar = 00 

Punkt 16 : Bitpaar = 01 


Tabelle der Spritefarbregister: 


0 und 1 00 16 4 und 5 00 24 
01 17 01 25 
10 18 10 26 
2 19 2 27 
2 und 3 00 20 6 und 7 00 28 
ol 21 01 29 
10 22 10 30 
24 23 11 31 


Das Bitpaar OO enthält keine Farbe, sondern erscheint durchsichtig. 


Wenn die drei Farben für einen Sprite nicht reichen sollten, so kann 
man zwei Sprites zu einem Attached-Sprite zusammenfassen, welcher 
aus 16 Farben besteht. Allerdings können nur die oben aufgeführten 
Spritepaare kombiniert werden. Die Größe und Position der beiden 
Sprites muß immer gleich sein. 


Durch Kombination der beiden Spritezeilen erhält man nunmehr vier 
Words und damit für jeden Punkt eine Kombination von vier Bits, 
also einen Wertebereich von O bis 15, die dann die Farbregister 16 
bis 31 anwählen. 
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Zum Beispiel: 


SpriteO LowWord (Bit 0) 1000000000000000 
SpriteO HighWord (Bit 1) 1000000000000000 
Spritel LowWord (Bit 2) 0000000000000000 
Spritel HighWord (Bit 3) 1000000000000000 


Punkt 1 hat die Bitkombination 1011 und erhält somit seine Farbe 
aus dem Farbregister 27. 


Zuwei r Farbregister für Attached-Sprites: 
Binär___Farbregi Binär__F ister 
0000 16 1000 24 
0001 17 1001 25 
0010 18 1010 26 
0011 19 1011 27 
0100 20 1100 28 
0101 21 1101 29 
0110 22 1110 30 
0111 23 1137 31 


Für das Darstellen der Spritess braucht der Amiga nur eine 
Spritedatenliste, in der das Aussehen, die Größe und die Position 
enthalten sind. Alles andere erledigt die Sprite-DMA. 


Aufbau einer Spritedatenliste: 
SpriteX: 
dc.w ControllWord1,ControllWord2 ; Position, Größe etc. 


dc.w LowWord,HighWord ; 1. Zeile 
dc.w LowWord,HighWord ; 2. Zeile 


j... hier folgen so viele Zeilen, wie in Höhe angegeben 


dc.w 0,0 ; Ende der Spritedatenliste (Wichtig) 
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Die beiden Null-Words am Ende der Liste sind sehr wichtig, da sie 
dem Sprite-Controller mitteilen, daß ab hier keine Daten mehr 
folgen. 


Den Grafikaufbau der Zeilen (High- u. LowWord) haben wir ja schon 
besprochen, was uns jetzt noch fehlt sind die ersten beiden 
Controllwords. Denn diese enthalten alle wichtigen Parameter wie 
Höhe, Farbanzahl und Position des Sprites. 


Aufbau _des ersten Controllwords: 


Bit: 35 14 13 12 11 10 89 08 07 06 85 04 03 02 01. 00 
Funktion: E7 E6 E5 E4 E3 E2 Eli EO H8 H7 H6 H5 H4 H3 H2 Hi 


Aufbau des zweiten Controllwords: 


Bit: 15: 14 13 12 11 10 89 08 07 06 05 04 083 02 01 00 
Funktion: L7 L6 L5 L4 L3 L2 Li LO AT 00 00 00 00 E8 L8 HO 


Erläuterung: 

HO bis H8 = Horizontale Position des Sprites (HStart) 

EO bis E8 = vertikale Startposition des Sprites (VStart) 

LO bis LB = vertikale Stopposition des Sprites + 1 (VStop) 
AT = Attach-Kontrollbit (15-Farben-Sprite) 


Die Koordinaten des Sprites beziehen sich auf die Begrenzungen des 
Bildschirmfensters (DIWSTRT und DIWSTOP). Wird ein Sprite außer- 
halb dieser Begrenzungen bewegt, so werden alle überstehenden 
Punkte von der Hardware abgeschnitten (siehe Mauszeiger). Die 
vertikale Startposition bezieht sich auf die linke, obere Ecke des 
Sprites und die vertikale Stopposition auf die letzte Zeile des Sprites 
+1. Die Höhe des Sprites ist also VStop-VStart. Möchte man ein 
Attached-Sprite erzeugen, so muß das AT-Bit im 2. Controllword des 
ungeraden Sprites (Nr. 1, 3, 5 und 7) gesetzt werden. 
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Folgendes Beispiel stellt einen Sprite auf die Positionen X = 81 und 
Y = 100 dar. Die Spritehöhe beträgt 8 Pixel und es handelt sich um 
einen normales Sprite. 


HStart = 81 = $51 = %0 0101 0001 (9 Bits) 
VStart = 100 = $64 = %0 0110 0100 

VStop = 108 = $6C = %0 0110 1100 

AT = 0 


1. ControllWord = % 0110 0100 0010 1000 = $6428 
2. ControllWord = % 0110 1100 0000 0001 = $6C01 


ri nli 
SpriteX: 
dc.w $6428,$6C0 1 ‚1. und 2. ControllWord 
dc.w $8000,$0001 ‚1. Zeile 
dc.w $c000,$0003 ‚2. Zeile 
dc.w $e000,$0007 ‚3. Zeile 
dc.w $f000,$000f ‚4. Zeile 
dc.w $Offf, $rffo ‚5, Zeile 
dc.w $0Oaaa, $aaal ‚6. Zeile 
dc.w $ffff, Hrfff ‚7. Zeile 
dc.w $fe00,$0000 ‚8. Zeile 
dc.w 0,0 ; Ende der Liste 


Es ist auch möglich mehrere Sprites über einen Spritekanal auszu- 
geben. Dazu läßt man lediglich die beiden Nullwords am Ende der 
Spriteliste weg und legt ab dort eine neue Spritedatenliste an. Dabei 
ist allerdings zu beachten, daß mindestens eine Zeile zwischen den 
beiden Sprites frei ist. Also wenn das alte Sprite bis Zeile 108 gehen 
würde, so dürfte das neue erst ab Zeile 110 beginnen. 
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Hat man jetzt seine Spritedatenlisten für alle acht Sprites angelegt, so 
muß dem Spritecontroller noch mitgeteilt werden, ab welcher Adresse 
diese beginnen. Dafür besitzt jeder Spritekanal ein eigenes Register. 


Adresse Name Funktion 

$DFF120 SPROPT Enthält Adresse für Sprite O (Longword) 
$DFF124 SPRIPT Enthält Adresse für Sprite 1 (Longword) 
$DFF128 SPR2PT Enthält Adresse für Sprite 2 (Longword) 
$DFF12C SPR3PT Enthält Adresse für Sprite 3 (Longword) 
$DFF130 SPRAPT Enthält Adresse für Sprite 4 (Longword) 
$DFF134 SPR5SPT Enthält Adresse für Sprite 5 (Longword) 
$DFF138 SPR6PT Enthält Adresse für Sprite 6 (Longword) 
$DFF13C SPR7PT Enthält Adresse für Sprite 7 (Longword) 


Diese Register werden genau wie die BPLxPT-Register der Bitmaps 
benutzt. Das heißt, daß sie intern raufgezählt und am Anfang eines 
Bildschirmaufbaus wieder auf die Anfangsadresse gesetzt werden 
müssen. Am besten läßt man dieses den Copper erledigen oder 
während der vertikalen Austastlücke. Sie müssen immer alle acht 
Sprites initialisieren, auch wenn Sie nicht alle benutzen. Diese läßt 
man dann auf leere Spritedatenlisten zeigen. 


Möchte man Sprites bewegen, so brauchen nur die Controllwords 
entsprechend geändert werden, aber auch während der vertikalen 
Austastlücke oder über den Copper. 


Prioritäten: 
Das Sprite Null hat die höhste Priorität und befindet sich vor allen 
anderen Sprites. Das Sprite Sieben wird von allen anderen verdeckt. 


Die Priorität in Bezug auf die Playfileds wurde bereits im Kapitel 10.1 
beschrieben. 
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Kollisionen: Spri Playfiel 


Für Spiele ist es zum Beispiel notwendig oder zumindest sehr 
hilfreich, zu wissen, ob sich zwei Sprites oder ein Sprite mit dem 
Playfield oder zwei Playfields berührt haben. 


Bei den Sprites lößt jeder gesetzte Punkt eine Kollision aus. Das heißt, 
sobald sich zwei Punkte von mindestens zwei Sprites überlappen, 
wird eine Kollision ausgelöst. Das Gleiche gilt natürlich auch in Bezug 
auf Playfields. Allerdings kann hier die Bitkombination eingestellt 
werden, bei denen eine Kollision ausgelöst wird. Anders ausgedrückt, 
bei welchen Farben eine Kollision möglich ist. Dieses wird in dem 
CLXCON-Register festgelegt. 


Register: N ($D nur schreiben 
ib 

15  ENSP7 Sprite 7 in Kollisionserkennung einbeziehen 
14  ENSP5 Sprite 5 in Kollisionserkennung einbeziehen 
13  ENSP3 Sprite 3 in Kollisionserkennung einbeziehen 
12 ENSP1I Sprite 1 in Kollisionserkennung einbeziehen 
11  ENBP6 Bitplane 6 mit MVBP6 vergleichen 
10 ENBP5 Bitplane 5 mit MVBP5 vergleichen 
9 ENBP4 Bitplane 4 mit MVBP4 vergleichen 
8 ENBP3 Bitplane 3 mit MVBP3 vergleichen 
7 _ENBP2  Bitplane 2 mit MVBP2 vergleichen 
6 ENBPI Bitplane 1 mit MVBP1 vergleichen 
5 MVBP6 Kollisionswert für Bitplane 6 (0 oder 1) 
4 MVBP5 Kollisionswert für Bitplane 5 (0 oder 1) 
3 MVBP4 Kollisionswert für Bitplane 4 (0 oder 1) 
2 MVBP3 Kollisionswert für Bitplane 3 (O0 oder 1) 
1 MVBP2 Kollisionswert für Bitplane 2 (0 oder 1) 
O0  MVBP1 Kollisionswert für Bitplane 1 (O oder 1) 
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Da Kollisionen nur zwischen Sprites mit gerader Nummer möglich 
sind, kann zusätzlich mit den ENSPx-Bits dieses auch für die Sprites 
mit ungeraden Nummern eingestellt werden. Allerdings kann man 
keine Kollision zwischen einem Spritepaar festellen, also zwischen 
Sprite O und 1, oder Sprite 2 und 3 etc. Benutzt man 15farbige 
Sprites, so müssen die entsprechenden ENSPx-Bits für eine korekte 
Kollisionserkennung gesetzt werden. 


Bei den Playfields kann eine Kollision bei jedem Punkt ausgelöst 
werden (ENBPx = 0). Möchte man Kollisionen nur bei bestimmten 
Punkten ermöglichen, so kann man dieses mit den ENBPx- und 
MVBPx-Bits bestimmen. 


Die ENBPx-Bits legen fest, welche Bitmaps mit dem Wert der 
dazugehörigen MVBPx-Bits verglichen werden sollen. Das heißt, wenn 
der Wert der Bitmaps, welche durch die ENBPx-Bits selektiert wurden, 
mit dem Wert der MVBPx-Bits übereinstimmt, könnte dort eine 
Kollision stattfinden. 


Beispiele: 


1) 
Es soll nur eine Kollision bei der Bitkombination 000001 möglich 
sein (Farbe aus Farbregister 1). 


ENBPx = 111111 (alle Bitmaps mit den MVBPx-Bits vergleichen) 
MVBPx = 000001 (Kollision nur mit Farbe aus Farbregister 1 möglich) 
2) 


Es soll nur eine Kollision bei der Bitkombination 011111 möglich 
sein (Farbe aus Farbregister 31). 


ENBPx = 111111 (alle Bitmaps mit den MVBPx-Bits vergleichen) 
MVBPx = 011111 (Kollision nur mit Farbe aus Farbregister 31 möglich) 
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3) 

Es soll nur eine Kollision bei den Bitkombinationen 010000, 010001, 
010010, 0100011 möglich sein (Farben aus Farbregister 16, 17, 18 
und 19). 


ENBPx = 111100 (Bitmaps 3 bis 6 mit den MVBPx-Bits vergleichen) 

MVBPx = 010000 (Kollision nur mit Farbe aus Farbreg. 16,17,18,19 möglich) 
weitere Beispiele in Kurzform: 

ENBPx_ MVBPx Bi r bei en Kollisi lich ist 


000000 xxxxxx bei jeder 

123331 zZ131231 2312372 

13111112 1100313 110931 

111111 111000 111000 

111110 00000x 000000, 000001 (Farbregister 0 und ]l) 
111101 0001x1 000101, 000111 (Farbregister 5 und 7) 


Wenn nicht alle sechs Bitmaps für einen Screen benutzt werden, so 
müssen die ENBPx-Bits der unbenutzten Bitmaps auf Null. 


Hat man jetzt die möglichen Kollisionen festgelegt, so wird das Er- 
gebnis einer solchen, in dem CLXDAT-Register gespeichert. 


Register: DAT ($DFFOOE) [nur lesen 


Bi lision zwischen 

15 unbenutzt 

14  Sprite 4 (oder 5) und Sprite 6 (oder 7) 

13  Sprite 2 (oder 3) und Sprite 6 (oder 7) 

12  Sprite 2 (oder 3) und Sprite 4 (oder 5) 

11  Sprite O (oder 1) und Sprite 6 (oder 7) 

10  Sprite O (oder 1) und Sprite 4 (oder 5) 

9  Sprite O (oder 1) und Sprite 2 (oder 3) 

8  Playfield 2 (gerade Bitplanes) und Sprite 6 (oder 7) 
7  Playfield 2 (gerade Bitplanes) und Sprite 4 (oder 5) 
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Playfield 2 (gerade Bitplanes) und Sprite 2 (oder 3) 
Playfield 2 (gerade Bitplanes) und Sprite O (oder 1) 
Playfield 1 (ungerade Bitplanes) und Sprite 6 (oder 7) 
Playfield 1 (ungerade Bitplanes) und Sprite 4 (oder 5) 
Playfield 1 (ungerade Bitplanes) und Sprite 2 (oder 3) 
Playfield 1 (ungerade Bitplanes) und Sprite O (oder 1) 
Playfield 1 und Playfield 2 


O—-Nw Pu oo 


Weitere Sprite-Register: 


Neben den bisher beschriebenen Registern, exestieren für jeden 
Sprite noch vier weitere, welche normalerweise automatisch vom 
DMA-Controller beschrieben werden. 


Name Funktion 
SPRxPOS erstes Kontrollword 


SPRXCTL zweites Kontrollword 
SPRXxDATA erstes Datenword einer Spritezeile 
SPRXDATB zweites Datenword einer Spritezeile 


Die Adressen dieser Register stehen im ersten Kapitel. 


Der DMA-Controller kopiert die beiden Kontrollwords in die Register 
SPRxPos und SPRxCTL. Durch schreiben in das SPRxCTL-Register wird 
die Spriteausgabe abgeschaltet, solange bis die Zeile in VSTART und 
Spalte erreicht wird. Jetzt werden immer jeweils zwei Datenwords aus 
der Spriteliste in die SPRxDATA und SPRXDATB-Register kopiert. 
Durch das Schreiben in das SPRxDATB-Register wird die 
Spriteausgabe wieder eingeschaltet, bis die letzte Zeile erreicht 
wurde. 


Nach diesem Prinzip kann man auch Spritess ohne DMA-Controller 
darstellen. 
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13. Das Multitasking-System 


Das Amiga-Betriebssystem ist bei allen Modellen fest in einem ROM 
integriert (außer A1000) und in bestimmte Bereiche eingeteilt. Jeder 
Bereich verwaltet seine speziellen Aufgaben, wie Grafik, Intuition 
(Oberfläche), DOS (Ein- u. Ausgaben) und Exec (Multitasking). 


Die Basis des Systems ist das Multitasking. Im Amiga ist die Exec- 
Library (Exec = Executive) für den reibungslosen Ablauf zuständig. 
Alle Nachrichten (Message), Signale, der Speicher usw. werden 
entsprechend der einzelnen Programme (Tasks) bearbeitet, so daß 
diese "gleichzeitig" und störungsfrei laufen. 


Bild13,a 
SvsBase (804) 
oxec. Library 
tipraries Devices ) [Resources | Tasks I [Tienory 
05 N -Traeksisk } <tanscıee YL__Reasy, ) [une 
"Intuition If  scen | Dion 1 war 1 cnunnz 1 
: a; an 
. Ce) 
CC.) 
"Interrupts | Forts/Message] 
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13.1 Die Exec-Library 


Die Funktionen zur Verwaltung des Multitaskings stellt uns die Exec- 
Library. Sie ist die erste und einzige Bibliothek, die wir über die feste 
Hardwareadresse "4" erhalten. Wie eine Library genau aufgebaut ist, 
besprechen wir in Abschnitt 13.4. So viel sei schon gesagt, daß jede 
Library mit einer LibNode-Struktur beginnt und danach dem Aufga- 
benbereich entsprechende Parameter folgen (positiver Bereich). Über 
den negativen Bereich erhalten wir die Sprungadressen zu den ein- 
zelnen Funktionen. 


13.2 Die ExecBase-Struktur 


Über die feste Adresse 4 erhalten wir die Basisadresse der Exec- 
Bibliothek. Je nachdem, welche Kickstart-Version Sie besitzen, ändert 
sich auch die Adresse. Deswegen sollten Sie niemals auf feste 
Adressen zugreifen. Vorgeschrieben ist auch, daß Sie die Basisadresse 
der Exec-Library und jeder anderen in das Register A6 schreiben, 
bevor eine Funktion aufgerufen wird. 


Auslesen der Exec-Basisadresse 

move.| 4,36 oder move.w 4,36 
Beide Varianten sind erlaubt, die zweite ist etwas optimierter. 
Natürlich gibt es noch weitere Befehlsfolgen um die Basisadresse 
auszulesen. Die beiden sind aber die gängigsten. 
Als nächstes werden wir den Aufbau der Exec-Basis erläutern. Auch 


wenn auf viele Parameter erst später eingegangen wird, haben wir 
schon mal den Grundstock für das Verständnis des Multitasking. 
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ab hier Library-Struktur (34 Bytes) 
Versionsnummer des Kickstart 

Checksumme über den 68000-Trap-Bereich 
Wert für ExecBase-Kontrolle 

(ExecBase) + (ChkBase) = 

eigene Reset-Routine (A5 = Rücksprungadresse) 
eigene Reset-Routine, aber System schon init. 
(über RTS = Rücksprungadresse) 
Warmstart-Vektor 

obere Grenze des SuperVisor-Stacks (Adresse) 
untere Grenze des SuperVisor-Stacks (Adresse) 
maximale Größe des CHIP-RAMs 

ah ae des Amiga-Debuggers 
Datenpufferadresse für Debugger 

Zeiger auf Alert-Datensegment (Fehleranzeige) 
maximale Größe des zusätzlichen RAMs 
Checksumme über 23 Words ab Offset 34 
(Addition => Ergebnis invertieren (not.w)) 


;-— Tabelle mit 16 Interrupt-Vektoren (je 12 Bytes) -— 


Interrupt-Vektor für serielle Ausgabe 
Interrupt-Vektor für Disk-DMA-Transfer 
Interrupt-Vektor für Software-IRQ 
Interrupt-Vektor für CIAA/Expansion-IRQ) 
Interrupt-Vektor für Copper-IRQ) 
Interrupt-Vektor für Vertikal-Blank-IRQ) 
Interrupt-Vektor für Blitter-IRQ 
Interrupt-Vektor für Audio-Kanal O 
Interrupt-Vektor für Audio-Kanal 1 
Interrupt-Vektor für Audio-Kanal 2 
Interrupt-Vektor für Audio-Kanal 3 
Interrupt-Vektor für serielle Eingabe 
Interrupt-Vektor für Disk-Sync-Erkennung 
Interrupt-Vektor für CIAB/Expansion-IRQ 
Interrupt-Vektor für internen IRQ) 
Interrupt-Vektor für Nicht-Maskierbarer-IRQ) 


;— ab jetzt folgen Taskabhängige Daten (für Task in READY) -- 
276 


D INg- 
r 

T 
000 LibNode 
034 W SoftVer 
036 W LowMemcChkSum 
038 L ChkBase 
042 L ColdCapture 
046 L CoolCapture 
050 L WarmCapture 
054 L SysStkUpper 
058 L SysStkLower 
062 L MaxLocMem 
066 L DebugEntry 
070 L DebugData 
074 L AlertData 
078 L MaxExtMem 
082 W ChkSum 
084 IVTBE,12 
096 IVDSKBLK,12 
108 IVSOFTINT, 12 
120 IVPORTS,12 
132 IVCOPER,12 
144 IVVERTB,12 
156 IVBLIT,12 
168 IVAUDO, 12 
180 IVAUD1,12 
192 IVAUD2,12 
204 IVAUD3,12 
216 IVRBF,12 
228 IVDSKSYNC,12 
240 IVEXTER,12 
252 IVINTEN, 12 
264 IVNMI,12 

L ThisTask 
280 L IdieCount 
284 L DispCount 
288 W Quantum 
290 W Elapsed 
292 W SysFlags 


Zeiger auf die aktuelle Task-Struktur (READY) 
idle-Zähler 

dispatch-Zähler (Abfertigung) 

Taskzeit 

aktuelle Anzahl Ticks für Quantum 

interne System-Flags 

SF SAR (Bit 15) = Scheduling-Attention-Required 
SF TQE (Bit 14) = Time-Quantum-Expended 

SF _SINT (Bit 13) = Soft-Interrupt erlauben 
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294 B IDNestCnt Disable ()-Aufrufzähler (-1 = IRQs erlauben) 
295 B TDNestCnt Forbid ()-Aufrufzähler (-1 = Multitasking erlauben) 
296 W AttnFlags InfoFlags für CPU,MMU,FPU (s. Kapitel 1) 
298 W AttnResched Rescheduling-Informationen 

300 L ResModules Zeiger auf Array mit residenten Modulen 

304 L TaskTrapCode Zeiger auf Task-Trap-Programm 

308 L TaskExceptCode Zeiger auf Task-Exception-Programm 

312 L TaskExitCode Zeiger auf Task-Exit-Programm 

316 L TaskSigAlloc Task-Signal-Maske 

320 W TaskTrapAlloc Task-Trap-Maske 

;--- Header (Köpfe) der Systemlisten (je 14 Bytes (ListHeader-Struktur)) -— 

322 MemList,14 ListHeader für Speicherverwaltung 

336 ResourceList,14 ListHeader für Resource-Strukturen 

350 DeviceList,14 ListHeader für Devices 

364 IntrList,14 ListHeader für Interrupts 

378 LibList, 14 ListHeader für Libraries 

392 PortList,14 ListHeader für Ports 

406 TaskReady, 14 ListHeader der Ready-Tasks 

420 TaskWait,14 ListHeader der Wait-Tasks 

434 Softints, 16x5 5 SoftIRQ-ListHeader a 16 Bytes 

;-- weitere allgemeine Infos über Exec --- 

514 LastAlert,4x4 Letzte Fehlernummer (Struktur) 

530 B VBlankFrequency  Bildwiederholfrequenz (50 Hz) 

531 8 PowerSupplyFrequency Frequenz der Netzspannung (50 Hz) 
532 SemaphoreList,14  ListHeader für Semaphoren 

546 L KickMemPir Zeiger auf MemList-Struktur für ROM 

530 L KickTagPtr Zeiger auf Haupt-Resident-Liste 

554 L KickCheckSum Zeiger auf Checksumme d. Funktion "SumKickData" 
;-- Infos erst ab Exec-V36 --- 

558 W ex _PadO reserviert für interne Funktionen 

560 L ex _LaunchPoint Intern für Launch/Switch (Multitasking) 

564 L ex RamLibPrivate Zeiger auf interne Funktionen 

568 L ex_EClockFrequency E-Clock-Takt (PAL = 709379) 

572 i ex CacheControl interne Bits für Cache-Funktionen (s. Kapitel 1) 
576 L ex_TaskID nächste mögliche Task-ID 

580 ex_Reserved1,5x4 reserviert (5 Longwords = 20 Bytes) 

600 L ex MMULock Zeiger für interne MMU-Funktion 

604 ex _Reserved2,3x4 reserviert (3 Longwords = 12 Bytes) 

;-- Infos erst ab Exec-V39 --- 

616 ex MemHandlers, 12 MLH-Struktur (Minimal-List-Header) 
628 L ex MemHandler Zeiger auf Memory-Handler 

632 Ende 
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13.3 Aufbau von Nodes und Listen 


Die gesamte Kommunikation im Amiga läuft über Strukturen bzw. 
Listen. Wie soll man auch sonst alle erforderlichen Parameter schnell 
übermitteln. Woher weiß das System nun, wo diese Listen im 
Speicher liegen? 


Der Amiga verbindet jeweils alle Listen einer Funktion zu einer Kette. 
Die Kette ist in beide Richtungen (Vor- und Rückwärts) verbunden. 
Das System verwaltet die Listen über Node-Strukturen. Sie hat eine 
Länge von 14 Bytes und enthält die Adresse des Vorgängers, 
Nachfolger, die Priorität und den Type der angehängten Struktur. Die 
Nodes sind sozusagen die Köpfe der Strukturen. 


r ListN 14 

Tr ; 
00 L LN Succ Zeiger auf nächste ListNode-Struktur 
04  L LN_Pred Zeiger auf vorangegangene ListNode-Struktur 
08 B LN Type Type der ListNode-Struktur (siehe unten) 
09 B LN _Pri Priorität der ListNode-Struktur (-127 bis 128) 
10 L LN_Name Zeiger auf Namen der ListNode-Struktur 
14 Ende 


Der Type gibt an, welche Art von Struktur nach der ListNode-Struktur 
folgt. 


i ür LN T 
00 NT_UNKNOWN (unbekannte ListNode) 
01 NT_TASK 
02 NT_INTERRUPT 
03 NT_DEVICE 
04 NT_MSGPORT 
05 NT_MESSAGE 
06 NT_FREEMSG 
07 NT_REPLYMSG 
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08 NT_RESOURCE 
09 NT LIBRARY 
10 NT MEMORY 
11 NT SOFTINT 
12 NT FONT 
13 NT PROCESS 
14 NT SEMAPHORE 
15 NT SIGNALSEM 
16 NT _BOOTNODE 
17 NT KICKMEM 
18 NT GRAPHICS 
19 NT _DEATHMESSAGE 
254 NT USER 
255 NT EXTENDED 


Damit das System sofort den Anfang und das Ende einer Liste 
bestimmen kann, wurde noch eine ListHead-Struktur eingeführt. Sie 
enthält unter anderem die Anfangs - und Endadresse einer Node- 
Liste. Die ListHead-Struktur stellt damit den Startpunkt für alle 
weiteren dar. Über die ExecBase ab Offset 322 sind alle Startpunkte 
(ListHead-Strukturen) für die Systemlisten zu finden. 


Aufbau der ListHead-Struktur (14 Bytes) 


tT Name Funktion 
00  L LH Head Zeiger auf erste ListNode-Struktur oder auf 
LH Tail, wenn Liste leer 
04  L LH Tail immer Null, als Kennzeichnung für letzten Eintrag 
08 L LH TailPred Zeiger auf letzte ListNode-Struktur oder auf 
LH Head, wenn Liste leer 
12 B LH Type wie LN_ Type 
13 B LH Pad Füll-Byte (unbenutzt) 
14 Ende 
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Beispiel einer Systemliste für drei Strukturen (Nodes) 
Bild13.b 
HERD NODE®8 NODE1 NODE2 


Serra a a an, 


ee | 


$Struktur® Strukturi1 Struktur? 





Als Assemblerlisting: 
lea Head,a0 ; Startpunkt (ListHead-Struktur) 
lea Node0,a] ; Al = NodeO 
move.| al,(a0) ; LH_Head => NodeO 
move.l a0,4(al) ; LN_Pred (Node0) => Head 
lea Node1,a2 ;A2 = Node! 
move.|l a2,(al) ; LN_Succ (Node0) => Node 
move.| a1,4(a2) ; LN_Pred (Nodel) => NodeO 
lea Node2,al ; Al = Node2 
move.|l al,(a2) ; LN_Succ (Nodel) => Node2 
move.l a2,4(al) ; LN_Pred (Node2) => Node] 
move.| a0,4lal) ; LN_Succ (Node2) => Head (LH Tail) 
move.l a1,8(a0) ; LH _TailPred => Node2 


Das Ganze sieht natürlich sehr unübersichtlich aus. Wie leicht kann 
man sich beim Verketten versehen. Die Exec-Library stellt uns dafür 8 
Funktionen bereit, die diese Aufgaben erledigen. 
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Routine: Insert (List, Node,Pred) (A0O,A1,A2) 
Offset: -234 
Parameter: AO = ListHeader-Struktur oder Null, wenn A2 nicht Null 


Al = ListNode-Struktur, die in die Liste eingefügt werden soll 

A2 = Vorgänger-ListNode-Struktur oder Null, wenn Al an erster 

Stelle stehen soll. 
Rückgabe: keine 
Erklärung: 
Insert fügt eine ListNode-Struktur in eine bestehende Liste. Die Position bestimmt Pred 
(A2). Ist dieser Zeiger auf Null, so wird die Node an den Anfang eingefügt, andernfalls 
nach der Vorgänger-Node. 


Routine: Remove (Node) (Al) 

Offset: -252 

Parameter: A1 = ListNode-Struktur, welche entfernt werden soll. 

Rückgabe: keine 

Erklärung: 

Remove entfernt die ListNode-Struktur auf die Al zeigt aus der entsprechenden Liste. 


Routine: AddHead (List, Node) (A0,A1) 

Offset: -240 

Parameter: AO = Zeiger auf eine ListHeader-Struktur 
Al = Zeiger auf ListNode-Struktur, die an die erste Stelle eingefügt 
werden soll. 

Rückgabe: keine 

Erklärung: 

AddHead fügt eine ListNode-Struktur (Al) an die erste Stelle einer Liste (AO) ein. 


Routine: RemHead (List) (AO) 

Offset: -258 

Parameter: AO = Zeiger auf eine ListHeader-Struktur 

Rückgabe: keine 

Erklärung: 

RemHead entfernt die erste ListNode-Struktur aus der angegebenen Liste. 


|... nn nn nn |. ..—.——n mm mn nn nn nn — m m u u m. ..—- 


Routine: AddTail (List, Node) (A0,A1) 
Offset: -246 
Parameter: AO = Zeiger auf ListHeader-Struktur 
Al = Zeiger auf ListNode-Struktur 
Rückgabe: keine 
Erklärung: 
AddTail fügt eine ListNode-Struktur (Al) an die letzte Stelle einer Liste (AO) ein. 
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Routine: RemTail (List) (AO) 
Offset: -264 

Parameter: AO = Zeiger auf ListHeader-Struktur 

Rückgabe: keine 

Erklärung: 

RemTail entfernt die letzte ListNode-Struktur aus der angegebenen Liste (AO). 


ee a A Me MA MM a A 


Routine: Enqueure (List, Node) (A0,A1) 
Offset: 270 
Parameter: AO = Zeiger auf ListHeader-Struktur 

Al = Zeiger auf ListNode-Struktur 
Rückgabe: keine 
Erklärung: 
Enqueure fügt eine ListNode-Struktur (A1) in eine bestehende Liste (AO) ein. Die 
Position wird durch die Priorität bestimmt. Je größer desto weiter am Anfang der Liste. 
Bei gleicher Priorität, wird die Node hinter diese eingefügt. 


zn ee ee ee ne ne  —_ 


Routine: FindName (List, Name) (A0O,A1) 
Offset: -276 
Parameter: AO = Zeiger auf ListHeader-Struktur 

Al = Zeiger auf ListNode-Struktur 
Rückgabe: => DO = ListNode-Struktur oder Null für Fehler 
Erklärung: 
FindName durchsucht eine Liste (AO) nach einer ListNode-Struktur, welche in LN_Name 
auf den angegebenen Namen (A1) zeigt. Das Ergebnis ist die Adresse der dazuge- 
hörigen ListNode-Struktur oder Null, wenn keine passende Node gefunden werden 
konnte. 


13.4 Aufbau einer Library 


Sämtliche Funktionen im Amiga sind zu Bibliotheken, die jeweils für 
einen bestimmten Themenbereich zuständig sind, zusammengefaßt. 
Eine solche Bibliothek wird als Library bezeichnet. Alle Libraries sind 
in positive und negative Bereiche eingeteilt. Der positive Bereich 
enthält library-spezifische Variabeln und der negative eine Sprung- 
tabelle, über die die einzelnen Funktionen erreichbar sind. 
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Die Funktionen einer Library kann man über ihre Basisadresse 
erreichen, welche wir von der Exec-Funktion "OpenLibrary ()" 
erhalten. In Al muß ihr ein Zeiger auf den Namen der Library und 
in DO die Versionsnummer übergeben werden. Der Name muß in 
Kleinbuchstaben vorliegen und endet immer mit ".library". Als 
Versionsnummer kann man auch eine Null in DO eintragen (jede 
Version). 


Routine: Openlibrary (LibName,Version) (A1,DO) 

Offset: -552 

Parameter: AI = Zeiger auf Library-Namen. Muß mit Null enden und in Klein- 
buchstaben vorliegen 
DO = Mindestversionsnummer der Library oder Null für egal 

Rückgabe: => DO = Adresse der Library-Basis (LibBase) oder Null, wenn die 
Library nicht geöffnet werden konnte. 

Erklärung: 

OpenLibrary ermittelt die Basisadresse einer Library und gibt sie in DO zurück. Bei 

einem Fehler ist das Ergebnis Null. 


Beispiel zum Öffnen der Graphics-Library 


lea gfxname,al ; Zeiger auf Library-Namen 

moveg #0,d0 ; Version = egal 

move.|l 4,36 ; Basisadresse der Exec-Library 

jsr -552(a6) ; Funktion: OpenLibrary () aus der ExecLib aufrufen 
move.l dO,gfxbase ; Basisadresse der Graphics-Library speichern 

beq Fehler ; bei Null => Fehler 

move.| gfxbase,a6 ; Basisadresse der Graphics-Library 

jsr -270(a6) ; WaitTOF-Funktion aus Graphics-Library aufrufen 


’ 


gfxname: dc.b "graphics.library",O 
even 
gfxbase: dc.1 O0 


Zu beachten ist, daß die Basisadresse einer Library immer in A6 steht, 
wenn eine Funktion aufgerufen wird. Einige Funktionen greifen über 
A6 auf die Variabeln im positiven Bereich zu und wenn sich die 
Basisadresse nicht in A6 befindet, kommt es zu einem Guru..... 
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jede Library, die man nicht mehr benötigt, muß über die Exec- 
Funktion "CloseLibrary ()" wieder geschlossen werden. Damit das 
System den belegten Speicher zurück erhält. 


Routine: CloseLibrary (Library) (A1) 


Offset: -414 
Parameter: A1 = Adresse der Library-Basis 
Erklärung: 


CloseLibrary schließt eine mit "OpenLibrary ()" geöffnete Bibliothek und gibt den 
belegten Speicher wieder zurück. 


iel zum ließen einer Libr 


move.l gfxbase,al ; Al = Library-Basis 
move.l 4,36 ; A6 = Basis-Adresse der Exec-Library 
jsr -414(a6) ; Funktion: CloseLibrary () aufrufen 


Viele Libraries befinden sich schon im Kickstart-ROM, die restlichen 
im Libs-Verzeichnis der Workbench bzw. Bootdiskette. 


Wie ist nun eine Library aufgebaut? 


Den positiven Aufbau einer Library für die Exec-Bibliothek haben wir 
bereits kennengelernt. Bis aus die ersten 34 Bytes und den negativen 
Bereich, ist dieser abhängig von der jeweiligen Library. 


Von der Basisadresse ausgehend, beginnt jede Library mit einer 
ListNode-Struktur über die alle Libraries im System verbunden sind. 
LN Type enthält den Wert 9 (NT_LIBRARY) und LN_Name zeigt auf 
den Namen der Library. Insgesamt macht das 34 Bytes, die jede 
Bibliothek besitzt. Was danach für Parameter folgen, ist library- 
abhängig. 
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Aufbau der LibraryBase-Struktur (min. 34 Bytes) 


Funktion 

ListNode-Struktur der Library (14 Bytes) 

siehe unten 

Füll-Byte (Null) 

Anzahl Bytes vor der Library (negativer Bereich) 
Anzahl Bytes nach der Library (pos. Bereich) 
Versionsnummer der Library 
Überarbeitungsnummer der Library 

Zeiger auf Info-String der Library (Version + Datum) 
Prüfsumme über die Library 

Zähler für Open/CloseLibrary-Aufrufe. Bei Null wird 
LIB_Expunge aufgerufen (s. unten) 

(ab hier beginnen libraryabhängige Daten) 


Mögliche Bits für LIB_Flags (Offset_14) 


D Ititaskin 
Offset T 

00 LIB Node 
14 B LIB Flags 
15  B LIB Pad 

16 W LIB_NegSize 
18 W LIB_PosSize 
20° W LIB_ Version 
22 W LIB_ReVision 
24 L LIB_IDString 
28 L LIB SUM 
32 W LIB OpenCnt 
34 Ende 

Bit N F 
0 LIBF_Summing 

1 LIBF_Changed 

2 LIBF_ SumUsed 

3 LIBF_DelExp 

4 LIBF ExpoCnt 


System berechnet gerade die Checksumme der Library 
Library wurde geändert, Checksumme nicht OK 
Checksummenberechnung jetzt erlaubt 

Library soll geschlossen werden, wird aber noch benutzt 
Spezial-Flag für Expunge-Funktion 


Der negative Bereich enthält, wie schon erwähnt, die Sprungvektoren 
der einzelnen Funktionen. Die ersten vier Vektoren sind vorgegeben 
und müssen entsprechend eingetragen werden. 


6 
12 
-18 
-24 


tN Funkti 
LIB Open Library öffnen (LIB OpenCnt +1) 
LIB_Close Library schließen (LIB OpenCnt -1) 


LIB Expunge Library entfernen (LIB OpenCnt = 0) 
LIB_ExtFunc für Erweiterungen (Rückgabe DO = 0) 


Ab Offset -30 liegen die einzelnen Funktionen der Library, die für 
den Programmierer von Bedeutung sind (in Abständen von 6 Bytes). 
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Die Exec-Library stellt uns auch hier wieder Funktionen zum Erstellen 
und Verändern von Libraries bereit. 


Möchten wir nur eine Funktion ändern bzw. ersetzen, müssen wir Al 
auf die Library-Basis setzen, AO enthält den Offset des zu ändernden 
Vektors und in DO die Adresse der neuen Funktion speichern. Danach 
übernimmt "SetFunction ()" alles weitere zum Einbinden der neuen 
Funktion. 


Routine: SetFunction (Library,FuncOffset,FuncEntry) (A1,A0,DO) 
Offset: -420 
Parameter: A1 = Zeiger auf Library-Basis 
AO = Offset des zu ändernen Vektors 
DO = Adresse der neuen Funktion 
Erklärung: 
SetFunction ändert einen Vektor der angegebenen Library (Al). Danach wird die 
Prüfsumme neu berechnet. 


Routinen zum Erstellen einer Li r 


Routine: InitStruct (InitTable,Memorvy,‚Size) (A1,A2,DO) 
Offset: -78 
Parameter: A1 = Zeiger auf Initialisierungstabelle mit Befehlen und Daten 
A2 = Speicheradresse, wo die Strukturdaten abgelegt werden können 
DO = Länge der fertigen Struktur 


Erklärung: 

InitStruct erzeugt aus den Informationen der InitTable (Al) eine Struktur die in 
Memory (A2) abgelegt wird. Die Länge der Struktur wird durch Size (DO) begrenzt. Die 
InitTable besteht aus Befehlsbytes und Befehlsdaten. Es folgt erst immer ein 
Befehlsbyte mit Daten die sich darauf beziehen und danach erneut ein Befehlsbyte mit 
Daten. Das Ende der Liste wird durch ein Null-Byte festgelegt. 


h InitTabl 


Bit_Funkti 
716 eigentlicher Befehl: 
00 = die folgenden Daten werden direkt in die Struktur kopiert 
01 = den folgenden Wert so oft wie in den Bits 0-3 angegeben in die Struktur 
kopieren 
10 = Wie "00", nur das die Daten ab dem Offset des folgenden Bytes in die 
Struktur kopiert werden 
11 = wie "10", nur daß jetzt 3 Bytes mit einem 24-Bit-Offset folgen 
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5/4 Datenbreite der Daten in der InitTable: 
00 = Longword (müssen auf geraden Adressen liegen) 
01 = Word (müssen auf geraden Adressen liegen) 
10 = Byte (Daten liegen direkt nach dem Befehlsbyte) 
11 = nicht erlaubt 
3-0 Anzahl Daten die folgen bzw. Zähler für Wiederholungen + 1 (max. 16 Werte 
=> 1111 = 15 + 1 = 16) 


1) Beispiel für Wiederholungen (8 Longwords) 
dc.b %01000111,$00 


dc.| 5 
dc.b $00 
7l& = 01 (Daten wiederholen) 
5/4 = 00 (Longword) 
3-0 = 1111=7+1=8 mal das Longword (Wert 5) in Struktur übertragen 
$00 = Füll-Byte, damit Longword auf gerade Adresse 
5 = Wert des Longwords 
$00 = Ende der InitTable 


2) Beispiel für Kopieren ab Offset 10 (3 Words) 
dc.b %10010010,$0A 
dc.w 1,2,3 
dc.b $00 


7/6 = 10 (Daten kopieren ab Offset xx) 

5/4 = 01 (Words) 

3-0 = 0010=2+1=3 Words 

$0A = Offset 10 

1,2,3 = Werte der Words, welche in die Struktur kopiert werden sollen 
$00 = Ende der InitTable 


3) Beispiel für Kopieren ohne Offset (4 Bytes) 
dc.b %0010001 1 
dc.b 10,20,30,40 
dc.b $00 
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7/6 = 00 (Daten kopieren ohne Offset) 
5/4 = 10 (Datenbreite: Bytes) 
3-0 = 0011=3+1=4 Bytes 


10,20,30,40 = Werte der Bytes, welche in die Struktur kopiert werden sollen 
$00 = Ende der InitTable 


| A A A Mb m A A a Mh A a Mh a a a a a a A A a a u A 


a Makelibrary (Funclnit,Structinit,Liblnit,DataSize,CodeS$ize) (AD-A2,D0,D1) 
Offset: -84 
Parameter: AO = Zeiger auf Vektorentablle mit Funktionsadressen (Longwords) 
oder Offsets (Words - Anfang und Ende dann mit $ffff beginnen) 
Al = Zeiger auf eine InitTable (s. InitStruct) oder Null, wenn Struktur 
von Hand initialisiert werden soll. 
A2 = eigenes Initialisierungsprogramm, wenn z. B. Al=0, oder Null 
DO = Länge der Struktur (min. 34 Bytes) 
D1 = Zeiger auf Segmentenliste für DOS (Null) 
Rückgabe: = >DO= Adresse der Library-Basis oder Null für Fehler 
Erklärung: 
MakeLibrary erzeugt eine Library-Struktur mit den wichtigsten Werten. In DO erhalten 
wir die Adresse der Basis, welche aber noch nicht der Systemliste zugeführt wurde. AO 
zeigt auf eine Tabelle, die mindestens die vier Grundfunktionen (Open,Close,Expunge, 
ExtFunc) enthalten muß. 


ee 


Routine: AddLibrary (Library) (A1) 
Offset: -396 


Parameter: A1 = Adresse der Library-Basis, welche noch nicht in der Systemliste 
enthalten ist. 

Erklärung: 

AddLibrary berechnet die Prüfsumme der Library, welche wir durch MakeLibrary 

erhalten haben und fügt diese der Systemliste zu. Jetzt kann auf die Library zuge- 

griffen werden. 


Tr a Te ee Te ee ee ze ee ee ze ee ze ee Te 


Routine: RemLibrary (Library) (A1) 


Offset: -402 
Parameter: A1 = siehe AddLibrary 
Erklärung; 


RemLibrary entfernt eine Library aus der Systemliste. Danach kann nicht mehr mit 
darauf zugegriffen werden. 
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Die bisherigen Funktionen sind für das Erstellen von Libraries zu- 
ständig, aber was ist mit den fertigen im ROM bzw. den externen im 
"Libs"-Verzeichnis? 


Solche Libraries haben einen bestimmten Aufbau, damit sie auch als 
solche identifiziert werden können. Das System sucht nach residenten 
Modulen, die für ein Device, Resource oder einer Library alle nötigen 
Informationen zum Initialisieren enthalten. 


Jedes Modul ist als Struktur aufgebaut und trägt die Bezeichnung 
"Resident-Module-Tag". Sie beginnt mit dem Wert "$4AFC" 
(RT_MatchWord), wonach das System zuerst sucht. Danach muß das 
nachfolgende Longword (RT_MatchTag) die Adresse der Struktur 
enthalten. Damit ist ein residentes Modul einwandfrei identifiziert. 
Die nächsten Informationen enthalten die Parameter zum initialisieren 
der Library, des Device oder der Resource. Entsprechend ruft das 
System die Funktion AddLibrary (), AddDevice () oder AddResource 
auf. 


Aufbau_der Resident-Module-Tag-Struktur (26 Bytes) 


T Funktion 
00 W RT_MatchWord 1. Kennzeichnung für Resident-Module 
02 ıL RT_MatchTag Zeiger auf Anfang der Struktur (2. Kennzeichnung) 
06  L RT_EndSkip frühste Adresse des nächsten residenten Moduls 
10 B RT_Flags Flags - siehe unten 
11 B RT_Version Versionsnummer 
12 8 RT_Type Module-Type (NT_Library, NT_Device, NT_Resource) 
13 B RT Pri Priorität (-127 bis 128) 
14 L RT_Name Zeiger auf Module-Namen 
18 L RT_IDString Zeiger auf ID-Namen 
22- I RT _Init Zeiger auf initialisierungsprogramm oder wenn 
RT_Flags (Autolnit=1) dann InitTable-Adresse 
26 Ende 
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Mögliche Bits für RT_F 1 


Bit_ 

0 RTW_ColdStart (initialisieren während ColdStart-Phase) 

1 RTW_SingleTask 

2 RTW_AfterDOS 

7 RTW_Autolnit (RT_Init = Adresse einer InitTable, sonst Initprogrammadresse) 


Interessant ist hier nur das Bit 7 (Autolnit). Setzt man es auf 1, dann 
muß RT_Init auf eine Tabelle mit vier Werten zeigen, welche für die 
Funktion MakeLib () erforderlich sind. Setzt man Autolnit auf Null, so 
muß in RT _Init die Adresse eines Programms stehen, welches dann 
selber die Struktur initialisieren muß. 


r InitTable Init = 1 


DataSize Länge der endgültigen Struktur (min. 34 Bytes) 


00 L 

04  L Funclnit Adresse der Vektortabelle (s. MakeLibrary) 

08 L Structlnit InitTable oder Null (siehe InitStruct-Funktion) 

re & Liblnit Zeiger auf InitPrg. oder Null (siehe MakeLibrary) 
16 Ende 


Wenn wir jetzt eine eigene externe Library erstellen wollen, müssen 
wir diese als lauffähiges Programm im Libs-Verzeichnis speichern. 
Denn die einzelnen Routinen auf die die Vektoren zeigen, können ja 
beliebige Adressen annehmen, je nachdem, wohin sie geladen 
werden. 


Die Funktion "OpenLibrary ()" sucht zuerst im Speicher nach der 
Library und danach im Libs-Verzeichnis der Boot-Disk. Eine externe 
Library wird in den Speicher geladen und alle Adresse entsprechend 
den Hunks (siehe Kapitel 7.4) korregiert. Jetzt wird nach dem 
residenten Modul gesucht ($4AFC-Kennzeichnung) und die Library 
initialisiert. 


Als Beispiel folgt jetzt ein Library-Listing. Dieses können Sie beliebig 
erweitern. Die Strukturlänge (LibSize) beträgt mindestens 34 Bytes. 
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Möchten Sie weitere Werte ab Offset 34 speichern, müssen Sie 
DataSize entsprechend vergrößern. In unserem Beispiel retten wir 
noch den SegList-Pointer, wodurch wir vier weitere Bytes benötigen 
(LibSize = 34 +4). 


Wenn Sie mit den Listing ihre eigene Library erstellt haben, müssen 
sie diese als Programm in das Libs-Verzeichnis Ihrer Bootdisk 
speichern. Mit dem zweiten Listing wird demonstriert, wie Sie die 
Test-Library nutzen können. 


1. Listing (Library-Aufbau) 


Do ee ee ee ee me Tee ee Te a Me Me ie m m m m Mm je Mm a Mu Ai A A Ma Am a dm Ma Au u um mas 


;--- Code als Programm speichern unter den Namen --- 
3--- "test.library" u 


Version = 37 
ReVision =2 
LibSize = 34+4 
moveq #0,d0O ; damit kein Absturz, wenn Library 
rts ‚ als Programm gestartet wird 
;--- Resident-Struktur für Library --- 
Resident: 
dc.w $4AFC ; RT_MatchWord (Resident-Kennzeichnung) 
dc.| Resident ; RT_MatchTAG (Anfang der Struktur) 
dc.! ResidentEnd ; RT_EndSkip (Ende der Resident-Struktur) 
dc.b % 10000000 ; RT_Flags (Autolnit Bit7 = RT_Init= >DataTable) 
dc.b Version ; RT_Version 
dc.b 9 ; RT_Type (NT_Library) 
dc.b O ; RT_Pri (Priorität = 0) 
dc.| LibName ; RT_Name 
dc.| IDString ; RT_IDString 
dc.! InitTable ; RT_Init (Tabelle, weil RT_Flags= Autolnit) 
dc.w O ; FüllWord, damit folgende Adresse durch 4 teilbar 


LibName: dc.b "test.library",O 
cnop 0,4 ; damit Adresse durch vier teilbar 


‘ 
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IDString: dc.b "test.library xx.x (24.12.95)",13,10,0 
cnop 0,4 ; damit Adresse durch vier teilbar 
ResidentEnd: ; Ende der Resident-Struktur 


We ee a A ae ee A a a a A Me a a Me a A m Mh a a a a a a Mn m 


InitTable: 
dc.! LibSize ; DataSize (DO) 
dc.| VektorTable ; Funclnit (AO) 
dc.! 0 ; Structinit (A1) 


dc.! InitRoutine ; Liblnit (A2) 


We A A 


;--- Initialisierungsroutine für Library --- 
InitRoutine: 

move.l dO,al ; Al = Library-Basis 

move.b #9,8(a]) ; LN_Type (NT _Library) 

move.| #LibName,10(a1) ; LN Name 

move.b #6,14(a1) ; LIB_Flags (Changed,SumUised) 


move.w #Version,20(a1) ; LIB_Version 
move.w #ReVision,22(al) ; LIB_ReVision 
move.|l #1DString,24(al) ; LIB_IDString 
;- ab hier Werte in eigene Struktur (ab Offset 34) eintragen --- 
move.| a0,34(a1) ; SegList für DOS retten 
rts 


Wo a 


VektorTable: 
dc.| Open 
dc.| Close 
dc.| Expunge 
dc.! ExtFunc 
dc.| Blinken ; ab hier eigene Vektoren (ab Offset -30) 
dc.l -1 ; Ende der Liste (Wichtig) 


Won ee a A He a a a a u a m 


Open: 
addqa.w #1,32(a6) ; LIB_OpenCnt +1 
bceir.b  #3,14(a6) ; LIB_Flags (DelExp=0) 
move.|l a6,dO 
rts 
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Close: 
moveq 
subq.w 
bne 
btst.b 
bne 

Close _End: 
rts 


Expunge: 
tst.w 
beq 
bset.b 
moveq 


#0,d0 
#1,32(a6) 
Close_End 


#3,14(a6) 
Expunge 


32(a6) 
Expunge_CIrLib 
#3,14(a6) 
#0,d0 


rts 
Expunge_ClIrLib: 


move.l 
move.| 
move.| 
jsr 

move.| 
moveq 


move.w 


sub.l 
add.w 
move.| 
jsr 
move.| 
rts 


ExtFunc: 
moveq 
rts 


36(a6),a 
a6,-(sp) 
4,a6 
-252(a6) 
(sp)+ ‚al 
#0,d0 
16(a1),dO 
d0,al 
18(a1),dO 
al,-(sp) 
-210(26) 
(sp)+ ‚a6 


#0,d0 


; LIB_OpenCnt -1 


; LIB_Flags (DelExp) = 1 ? 
‚ wenn ja, dann Expunge 


; LIB_Opencnt = O ? 


; LIB_Flags (DelExp) = 1 


; Node der SegList-Struktur 

; Remove () 

; eigene Library-Adresse 

; LIB_NegSize 

; Anfang des Library-Memory 
; + LIB_Pos$ize = MemSize 


; FreeMem () 


;--- ab hier eigene Routinen -__ 
; Libbasis (nicht ändern --- 


een 


j--- Ab = 


Blinken: 


move.w $dff006,$dff180 


btst 
bne 
rts 


#10,$dff016 
Blinken 


‚ Offset -30 
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— 5 m n Test-Libr 
EEE Beispiel, welches die Test-Library benutzt --- 
move.| 4,36 
moveq #37,d0 ; Version 
lea tstname,al ; LibName 
jsr -552(a6) ; OpenLibrary () 
move.l dO,tstbase 
beq Ende 
move.l tstbase,a6 ; Basis unser Library 
jsr -30(a6) ; Blinken () 
Ende: 
move.l tstbase,dO 
beq Ende_1 


move.| dO,al 
move.| 4,36 
jsr -414(a6) ; CloseLibrary () 


tstname: dc.b "test.library",O 
even 
tstbase: dc.| O 


13.5 Was ist ein Task? 


Der Amiga ist durch sein Multitasking in der Lage mehrere Prog- 
ramme "gleichzeitig" ablaufen zu lassen. Jedes Programm wird als 
"Task" bezeichnet. 


Aus Kapitel 1 wissen wir, daß das Herz im Amiga die 600x0-CPU ist, 


die immer nur ein Programm bearbeiten kann (User-Modus). Das 
Betriebssystem läuft im Super-Visor-Modus und wird alle 1/50 
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Sekunde (VertBlank-IRQ) angesprungen. Während dieser Zeit berech- 
net Exec über Tasklisten, welcher Task gerade abgearbeitet werden 
muß und schaltet ihn in den Running-Modus. Die restlichen Tasks 
befinden sich dann in einem anderen Zustand. 


Mögliche Taskzustände 


Zustand (State) Funktion 

Running aktiver Task (immer nur einer) 

Ready Task bereit zur Abarbeitung, aber nicht aktiv 
Waiting Task in Warteliste (Signal-Message) 

Added Task wurde gerade der Taskliste hinzugefügt 
Removed Task wird aus Taskliste entfernt 

Exception Task hat eine Exception ausgelöst 


13.5.1 Die Task-Struktur 


Jedes Programm hat seine eigene Task-Struktur, in der alle wichtigen 
Variabeln für das Multitasking enthalten sind. Einige Parameter und 
die Taskadresse spiegeln sich in der Exec-Struktur ab Offset 276. 


Aufbau der Task-Struktur (92 Bytes) 


Offset T Funktion 
00 tc_Node ListNode-Struktur für Taskliste (14 Bytes) 
14 B tc_Flags Task-Flags: 
Flag (Bit) Funktion 
ProcTime(O) Processzeit 
ETask(3) ETask-Pointer verwenden 
StackChk(4) 
Except(5) Exception 
Switch(6) Taskswitching erlauben 
Launch(7) Tasklaunching erlauben 
15 B tc_State Taskstatus (siehe Taskzustände) 
5 
TS Invalid (0) ungültig TS _Wait (4) 
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tc_IDNestCnt 
tc_TDNestCnt 
tc_SigAlloc 
tc_SigWait 
tc_SigRecvd 
tc_SigExcept 
tc_TrapAlloc 
tc_TrapAble 


tc_ExceptData 
tc_ExceptCode 
tc_TrapData 
tc_TrapCode 
tc_SPReg 
tc_SPLower 
tc_SPUpper 
tc_Switch 

tc_ Launch 
tc_Mementry 
tc_UserData 
Ende 


et Node 

et _ReplyPort 
et Length 

et _Parent 
et_UniquelD 
et Children 
et_TrapAlloc 
et_TrapAble 
et Result! 
et_Result2 
et TaskMsgPort 
Ende 


itel 1 
TS_Added (1) TS_Except (5) 
TS_Run (2) TS_Removed (6) 


TS_Ready (3) 

Zähler für Disable-Funktion (Aufrufe) 
Zähler für Forbid-Funktion (Aufrufe) 
Singalbits - reserviert 

Signale auf die gewartet wird 
Signale die empfangen wurden 
Signale für Task-Exception 
reservierte Traps 

mögliche Traps 


Zeiger auf ETask-Struktur, wenn Bit 3 (ETask) ge- 
setzt ist (ab V36), sonst sind die Einträge 
tc_TrapAlloc und tc_TrapAble gültig. 


Zeiger auf Daten für Exception-Process 

Zeiger auf Exception-Programm 

Zeiger auf Daten für Trap-Process 

Zeiger auf Trap-Programm 

Adresse des Task-Stackpointer 

Zeiger auf untere Stackgrenze 

Zeiger auf obere Stackgrenze 

Funktionszeiger für Taskumschaltung (NoRunning) 
Funktionszeiger für Taskumschaltung (Running) 
ListHead-Struktur für belegten Task-Speicher 
Zeiger auf Task-Daten (unwichtig) 


Funkti 
Nodetist-Struktur (14 Bytes) 

Zeiger auf Message-AntwortPort 

Länge der Message in Bytes 

Zeiger auf eigene Task-Struktur 

ID-Nummer für diesen Task 
MinimalListHeader-Struktur für weitere ETasks 
siehe oben 

siehe oben 

erstes Ergebnis 

Zeiger auf zweites Ergebnis (AllocVec) 
MessagePort-Struktur (34 Bytes) 
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Die einzelnen Programme sind über ihre Task-Strukturen (Nodes) im 
System zu Ready- und Wait-Listen verbunden, deren Anfänge wir in 
der Execbase ab Offset 406 finden. Erst wenn der Running-Task seine 
ihm zugeteilte Rechenzeit verbraucht hat, wird über die Priorität der 
nächste aus der Readyliste berechnet und in das ThisTask-Feld (Offset 
276) der Execbase eingetragen. Die Task in der Waitliste kommen 
erst zum Zuge, wenn das entsprechende Ergebnis auf das sie warten 
eingetreten ist. Bei diesem Taskwechsel (Task-Switching) werden 
natürlich alle Daten wie Stack, Register usw. zwischengespeichert und 
die neuen in die Execbase übertragen. Der Stackbereich sollte 
ausreichend bemessen sein (> 1 KByte). 


Oft ist es notwendig das Taskswitching zu unterbrechen, um nicht 
vom System gestört zu werden. Hierfür sind die Exec-Funktionen 
Forbid (Offset -132) und Permit (Offset -138) vorhanden. Forbid 
verbietet das Umschalten und Permit erlaubt es wieder. Beide 
Funktionen benötigen keine Parameter und geben auch keine zurück. 


Beispiel zum Verbieten/Erlauben des Multitasking: 


move.| 4,36 

jsr -132(a6) ; Multitasking aus 
move.|l 4,36 

jsr -138(a6) ; Multitasking wieder ein 


Leider wird das Multitasking durch gewisse Vorgänge, wie Disk- 
Operationen wieder aktiviert und unser Programm könnte doch 
Störungen unterliegen. Die Ursachen sind System-Interrupts, die eine 
höhere Priorität als die Task haben und somit bei einem IRQ-Ereignis 
unser Programm unterbrechen. Mit den Exec-Funktionen Disable 
(Offset -120) und Enable (Offset -126) kann man die totale Kontrolle 
über das System erreichen. Disable () verbietet alle Interrupts und 
Enable () stellt den Ausgangszustand wieder her. Auch diese 
Funktionen benötigen keine Parameter. 


Seite 488 


iel zum i r n_der In 
move.| 4,36 
jsr -120(a6) ; Multitasking + Interrupts aus 
move.| 4,36 
jsr -126(a6) ; Multitasking + Interrupts wieder ein 
Exec-Funktionen für die Task-Verwaltung: 


Routine: AddTask (Task,InitPC,FinalPC) (A1,A2,A3) 
Offset: -282 
Parameter: A1 = Adresse einer Task-Struktur, in der mindestens die Felder 
tc_SPUpper, tc_SPLower, tc_SPReg und In_Type init. sind. 
A2 = eigene Programmadresse (Code) 
A3 = Adresse eines Programms, was nach Beendigung des Task-Codes 
(A2) aufgerufen wird oder Null für Standard-System-Programm 
Erklärung: 
AddTask fügt einen neuen Task der Systemliste hinzu. Das Adreßregister A3 kann die 
Adresse eines Beendigungsprogramms enthalten, um z. B. den belegten Speicher 
freizugeben. Ist A3 Null, so wird die Standard-Exec-Routine benutzt, die den belegten 
Speicher in der tc_MemeEntry-Struktur zurück gibt. 


Routine: FindTask (Name) (A1) 

Offset: -294 

Parameter: A1 = Zeiger auf Task-Namen 

Rückgabe: = >DO=Task-Struktur oder Null für Fehler 
Erklärung: 


FindTask durchsucht die Tasklisten (Ready+Wait) nach den angegebenen Tasknamen 
und gibt die Adresse der dazugehörigen Task-Struktur zurück oder Null bei einem 
Fehler. 


Routine: RemTask (Task) (A1) 

Offset: -288 

Parameter: A1 = Adresse einer Task--Struktur 
Erklärung: 


RemTask entfernt einen Task (Al) aus der Systemliste und gibt den belegten Speicher 
wieder zurück (tc_ MemEntry). 
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Routine: SetTaskPri (Task,Priority) (A1,DO) 

Offset: -300 

Parameter: Al = Adresse einer Task-Struktur 
DO = neue Priorität des Tasks 

Rückgabe: =>DO=alte Priorität 


Erklärung: 
SetTaskPri setzt die Priorität einer Task-Struktur auf einen neuen Wert (DO). Der alte 


Wert wird in DO zurückgegeben. 


13.5.2 Die Task-Signale 


Bisher haben wir "nur" das eigentliche Multitasking beschrieben. 
Doch was nützen uns Programme (Tasks) die "gleichzeitig" ablaufen, 
aber keine Informationen untereinander austauschen können - recht 
wenig. Exec stellt für diesen Zweck Signale bereit, über die auf 
bestimmte "externe" Ereignisse gewartet werden kann. 


In der Task-Struktur sind dafür mehrere Longwords reserviert (ab 
Offset 18). Das Lo-Word (Bits O bis 15) enthält immer die System- 
signale, auf die wir direkt keinen Einfluß haben und das Hi-Word 
(Bits 16 bis 31) ist für den Benutzer frei, 


Möchte man ein Signal benutzen, so muß dieses vorher reserviert 
werden (tc_SigAlloc). Mit der Wait ()-Funktion kann man dann auf 
das gewünschte Signalbit warten. Der Task wird solange in die Wait- 
liste eingetragen und verbraucht nahezu keine Rechenzeit mehr. Die 
Waitsignale werden in tc_SigWait eingetragen. Tritt das Ereignis ein, 
werden die Ereignissignale in tc_SigRecvd und in DO gespeichert 
(Wait-Funktion). Der Task befindet sich jetzt wieder in der Readyliste. 
Durch AND-Verknüpfung mit dem tc_SigWait-Wert erhält man das 
gewünschte Ergebnis. 
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-Funktionen zur Signal- 


Routine: AllocSignal (SignalNum) (DO) 

Offset: -330 

Parameter: DO = Bitnummer des Signals (0-31) oder -1 für nächstes freies Signal- 
bit reservieren 

Rückgabe: =>DO=belegte Signalnummer (OK) oder -1 für Fehler 

Erklärung: 

AllocSignal reserviert ein er für den eigenen Task (tc_SigAlloc). Die Signal- 

nummer wird in DO oder -1 für Fehler zurückgegeben. 


Routine: FreeSignal (SignalNum) (DO) 


Offset: -336 

Parameter: DO = Bitnummer des Signals (0-31) 

Erklärung: 

FreeSignal gibt das angegebene Signalbit wieder frei (löschen in tc_SigAlloc). 
Routine: i (Task,SignalSet) (A1,DO) 

Offset: 324 


Parameter: AI = Zeiger auf eine Task-Struktur 
DO = eine Signalmaske, mit den gewünschten Signalbits 
Erklärung: 
Mit Signal () lassen sich Signalbits eines anderen Tasks setzen (tc_SigRecvd), das dann 
entsprechend darauf reagieren kann. 


Routine: Wait (SignalSet) (DO) 


Offset: -318 
Parameter: DO = Signalmaske, mit den gewünschten Signalbits 
Rückgabe: = >DO=Signalmaske mit den empfangenen Signalbits 


Mit Wait () kann auf bestimmte Signalbits (DO) gewartet werden. Der Task wird so- 
lange in die Waitliste eingetragen. Als Ergebnis werden die empfangenen Signalbits in 
DO zurückgegeben und der Task wird wieder in die Readyliste übertragen. 


Routine: SetSignals (newSignals,SignalSet) (DO,D1) 
Offset: -306 
Parameter: DO = Signalbits, welche gesetzt werden sollen 

D1 = Signalmaske der Bits, welche betroffen sind 
Rückgabe: = >DO=alten Wert von tc_SigRecvd 
Erklärung: 
Mit SetSignals lassen sich die Signalbits in tc_SigRecvd setzen. Alle Signalbits die in 
newSignals (DO) =1 und in SignalSet (D1) =1 sind, werden in tc_SigRecvd gesetzt. 
Alle Signale die in newSignals (DO) =O und in SignalSet (DI) =1 sind, werden in 
tc_SigRecvd gelöscht. Die restlichen Signale werden nicht beeinflußt. 
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13.6 Das Amiga-Message-System 


Alleine nur mit Signalen lassen sich nicht viele Informationen austau- 
schen. Sie sind höhstens für das Kennzeichnen von Nachrichten zu ge- 
brauchen. Deswegen stellen die Signale auch die Grundlage für das 
Nachrichtensystem im Amiga dar. Eine Nachricht wird im englischen 
als Message bezeichnet. 


Nachrichten werden im Amiga über sogenannte Message-Ports (Nach- 
richtensammelstelle) übermittelt und die Signale zeigen dem je- 
weiligen Task das Auftreten von Messages. Die MessagePort-Struktur 
enthält dann alle gesendeten bzw. empfangenen Daten. 


Jeder MessagePort enthält am Anfang wieder eine ListNode-Struktur, 
über die alle Messages im System verbunden sind und am Ende 
befindet sich eine ListHead-Struktur, die auf die erste Message zeigt. 
Dadurch sind Warteschlangen von Nachrichten für jeden einzelnen 
Port möglich, die der Reihe nach ausgewertet werden können. 


Aufbau der MessagePort-Struktur (34 Bytes) 


Offset T Funktion 

00 mp Node ListNode-Struktur für diesen MsgPort 
(In Type = NT_MSGPORT) 

14 B mp _Flags Aktionsflags für diesen MsgPort (s. unten) 

Ss ® mp_SigBit enthält die Signalnummer des Ereignis (Ein Wert 
zwischen O und 31, immer nur ein Wert) 

 L mp_SigTask Zeiger auf Task-Struktur für die Nachrichten 

20 mp_Msglist ListHeader-Struktur für Message-Liste (14 Bytes) 

34 Ende 
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li erte für mp _Fl 14 
Funkti 
0 PA _SIGNAL Beim Eintreffen einer Nachricht, Signal an MP_SigTask 
(mp_SigBit enthält die Signalnummer) 
1 PA_SOFTINT Beim Eintreffen einer Nachricht, SoftIRQ auslösen 
(MP SigTask zeigt auf Interrupt-Struktur) 
2 _PA_IGNORE Es passiert nichts beim Eintreffen einer Nachricht 


Die eigentlichen Daten einer Message werden in einer Message- 
Struktur untergebracht. Der mp_MsglList-Eintrag zeigt auf die erste 
Message-Struktur, alle weiteren (sofern vorhanden) sind über List- 
Node-Strukturen miteinander verbunden. Dabei wird nach dem FIFO- 
Prinzip verfahren (First In = First Out). Das bedeutet, daß jede neue 
(gesendete) Nachricht an das Ende der Liste gehängt und bei jeder 
empfangenen, die erste Nachricht der Liste übermittelt wird. 


rM r 64KB 20 
1 : 

00 mn_Node ListNode-Struktur für diese Message 
(In_Type = 5, 6 oder 7) 

14 L mn_ReplyPort Adresse des Message-Antwort-Port (siehe unten) 

18 W mn Length Länge der Message in Bytes. Die Daten folgen 
direkt im Anschluß (ab Offset 20) 

DE mn Data ab hier folgen die Message-Daten 

Ablauf des Message-Systems 


Verwenden wir als Beispiel zwei Tasks die Nachrichten (Daten) unter- 
einander austauschen wollen (Task A möchte Task B Daten über- 
mitteln). Dazu müssen wir über einen MessagePort verfügen. Diesen 
können wir mit der Exec-Funktion AddPort () der Systemliste zufügen. 
jetzt sendet Task A mit PutMsg () die Daten in Form einer Message- 
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Struktur an diesen Port und wartet mit hilfe des ReplyPorts 
(mn_ReplyPort) auf die Antwort des Task B, daß dieser die Daten 
abgeholt hat. Task B wartet derweil schon mittels der Funktion 
WaitPort () auf die gesendeten Daten. Solange befindet sich der Task 
B in der Waitliste. Sobald die Daten eingetroffen sind (Message in 
Liste eingetragen) wird unser Task B wieder aktiviert (Readyliste) und 
kann jetzt die Daten mit der GetMsg () abholen. Als letztes teilen wir 
dem Task A über den ReplyPort (mn_ReplyPort) durch ReplyMsq () 
mit, daß wir die Nachricht empfangen haben und die Message wird 
daraufhin aus der Liste entfernt. Task A erfährt dieses zum Beipiel 
durch bestimmte Werte im ReplyPort (siehe Kapitel 5). 


Der Sender muß nicht unbedingt auf eine Antwort durch den Reply- 
Port warten, um zu erfahren, daß die Message bei Empfänger 
eingetroffen ist. Das ist Abhängig von der Art der Message. Zum 
Beispiel wird beim Programmstart über die Workbench auch eine 
Message an das Programm (Task) gesendet. Wird diese nicht 
abgeholt, kann es späuter bei Nachrichten evtl. zu Abstürzen 
kommen (siehe Kapitel 7.5). 


Funktionen zur Message-Verwaltung 


Routine: AddPort (Port) (A1) 

Offset: -354 

Parameter: AI = Zeiger auf eine MessagePort-Struktur 
Erklärung: 


AddPort fügt eine MessagePort-Struktur (Al) in die Systemportliste (Execbase => 
PortList, Offset 392). Die Priorität bestimmt die Stelle in der Liste und damit die 
Dringlichkeit. Es wird auch der mp_MsglList-Eintrag korekt initialisiert. 


.e | | | | u a og m m nn m nn nn m m m nn nn m m nn nn nn m m m Sn nn mn m nn So m m m m u m 


Routine: RemPort (Port) (Al) 

Offset: -360 

Parameter: AI = Zeiger auf eine MessagePort-Struktur 
Erklärung: 


RemPort entfernt einen MessagePort wieder aus der Systemliste der Ports. Dieser kann 
dann nich mehr mit den folgenden Funktionen angesprochen werden. 


ee | | u [. n  [  .  _  .— 
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Routine: FindPort (Name) (A1) 

Offset: -390 

Parameter: AI = Zeiger auf eine Portnamen (In_Name) 

ee = > DO= MessagePort-Adresse oder Null für Fehler 
Erklärun 


FindPort durchsucht die Systemliste nach den angegebenen Portnamen. Als Ergebnis 
wird die Adresse der MessagePort-Struktur oder eine Null für Fehler zurückgegeben. 


Routine: PutMsg (Port,Message) (AO,A1) 

Offset: -366 

Parameter: AO = Zeiger auf eine MessagePort-Struktur 
Al = Zeiger auf eine Message-Struktur 

Erklärung: 


PutMsg sendet eine Message (Al) an den angegebenen Port (AO). Die Message wird 
an die Liste der Message-Strukturen gehängt (mn_Node). 


Routine: WaitPort (Port) (AO) 

Offset: -384 

Parameter: AO = Zeiger auf eine MessagePort-Struktur 

Rückgabe: =>DO=Adresse der ersten Message-Struktur für den angegeben Port 
Erklärung: 


Mit WaitPort kann auf eine Nachricht des angegebenen Ports (AO) gewartet werden. 
Das Programm muß solange warten (Waitliste), bis die Message eingetroffen ist. Die 
Nachricht kann mit GetMsg () abgeholt werden. 


see | | = | nn nn | 


Routine: GetMsg (Port) (AO) 
-372 


Offset: 
Parameter: AO = Zeiger auf eine MessagePort-Struktur 
Rückgabe: =>DO=Adresse der ersten Message-Struktur für den angegeben Port 


oder Null, wenn keine Message vorhanden 
Erklärung: 
Die Funktion entspricht der von WaitPort. Allerdings wird hier nicht bei einer leeren 
Liste gewartet bis die Message eintrifft, sondern sofort eine Null zurückgegeben. Mit 
GetMsg können in Form einer Schleife mehrere Nachrichten ausgewertet werden. 


Routine: ReplyMsg (Message) (A1) 
Offset: -378 


Parameter: A1 = Adresse der Message-Struktur (von GetMsg, WaitPort) 

Erklärung: 

ReplyMsg sendet eine Message, die wir mit GetMsg oder WaitPort erhalten haben an 
den ReplyPort des Senders. Der Eintrag In_ Type muß NT_REPLYMSG enthalten (wird 
automatisch gesetzt). Der Sender kann dann entsprechend darauf reagieren (z.B. Port 
wieder entfernen). 
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Task- und CPU-Exceptions 


Aus Kapitel 1 wissen wir, daß Exceptions Ausnahmezustände des 
Prozessors sind. Exec bietet aber noch die Möglichkeit der Task- 
Exception. Sie funktionieren ähnlich den Signalen. Auch hier können 
mit der Funktion SetExcept Signale reserviert werden, bei denen der 
laufende Task unterbrochen wird. Diese werden in tc_SigExcept 
gespeichert. Tritt jetzt eine Task-Exception auf, wird das Programm in 
tc_ExceptCode ausgeführt. Zuvor wurden aber noch alle Register (Dx, 
Ax, SR, ...) auf den Task-Stack abgelegt, damit der Task ordnungs- 
gemäß seine Arbeit fortführen kann. In DO steht das Exception-Signal, 
das den Task unterbrochen hat und A1 enthält die Adresse von 
tc_ExceptData. Das Except-Programm muß mit einem RTS enden und 
darf den Wert in DO nicht ändern. 


Routine: SetExcept (NewSignals,SignalSet) (DO,D1) 

Offset: -312 

Parameter: DO = siehe SetSignal () für Task-Exception 
D1 = siehe SetSignal () für Task-Exception 

Rückgabe: = >DO=alten tc_SigExcept-Wert 


Erklärung: 
Die gleiche Funktion wie SetSignals (), aber für Task-Exception. 


Kommen wir zu den Prozessor-Traps zurück. Auch diese lösen einen 
Ausnahmezustand aus und unterbrechen das laufende Programm. Das 
ganze funktioniert aber auf Hardware-Basis. Bei welchen Ereignissen 
(Traps) eine Exception ausgelöst wird, können Sie Kapitel 1 ent- 
nehmen. Wir wollen hier nur den Ablauf einer Trap-Behandlung 
beschreiben. 


Bei einem Prozessor-Trap werden die Register und die Trapnummer 
auf den Stack gerettet und das Standard-Programm in tc_TrapCode 
aufgerufen. Dabei handelt es sich um die Guru-Meldung des Systems 
(Super-Visor-Modus). Sie können aber auch ein eigenes Trap- 
Programm in tc_TrapCode eintragen, welches aber mit einem RTE 
enden muß und den alten Stackpointer richtig korregiert. Die 
Korrektur ist Abhängig vom jeweiligen Prozessor. 
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Die Trapnummer, bei der eine Exception zugelassen wird, muß 
vorher mit der Funktion AllocTrap für den Task reserviert werden. Die 
möglichen Traps speichert das System in tc_TrapAlloc. 


Routine: AllocTrap (TrapNum) (DO) 
2 


Offset: -34 

Parameter: DO = Trapnummer oder -1 für nächsten freien Trap reservieren 
Rückgabe:  =>DO=Trapnummer oder -1 für Fehler 

Erklärun 


AllocTrap reserviert die gewünschte Trapnummer (DO) und speichert sie in tc_Trap- 
Alloc. 


ss ss = ss sn sn 


Routine: FreeTrap (TrapNum) (DO) 
Offset: 348 

Parameter: DO = Trapnummer (0 bis 15) 

Erklärung: 

FreeTrap gibt die gewünschte Trapnummer (DO) wieder frei und löscht es in tc_Trap- 
Alloc. 


13.7 Verwaltung des Speichers 


Der Amiga unterteilt den Speicher in CHIP- und FAST-RAM. Das 
CHIP-RAM kann bis zu 2 MByte betragen - Abhängig vom Agnus/ 
Alice-Chip (Kapitel 1). Es ist hauptsächlich verantwortlich für Grafik- 
daten (Bildschirm, Sprites etc.). Jeder zusätzliche Speicher, ob 16 oder 
32 Bit wird allgemein als Extended-Memory bezeichnet. 


Der Amiga verwaltet seinen freien Speicher über Strukturen. So weis 
das System sofort über die noch zu Verfügung stehenden Speicherbe- 
reiche Bescheid. Der kleinste Speicherblock kann 8 Bytes betragen. 
Damit ist die Anfangsadresse immer mindestens durch acht teilbar. 


Der Memlist-Eintrag (Offset 322) in der Execbase enthält eine 


ListHead-Struktur, die auf den ersten freien Speicherblock zeigt, 
welcher durch eine MemHeader-Struktur verwaltet wird. Alle freien 
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Speicherbereiche sind wieder über ListNode-Strukturen miteinander 
verbunden. | 


Aufbau der MemHeader-Struktur (32 Bytes) 


Cie Typ___Name Funktion 
mh Node ListNode-Struktur (In Type = NT_MEMORY) 
14 W mh_Attributes Art des Speicherblocks (siehe unten) 
6 ı mh_First Zeiger auf erste MemChunk-Struktur 
20 L mh Lower Zeiger auf Speicherblockanfang 
24 L mh _Upper Zeiger auf Speicherblockende 
28 L mh_Free Größe des freien Speicherblocks in Bytes 
32 Ende 


Mit mh_Attributes wird die Art des Speichers beschrieben, wie Chip, 
Fast etc.. Außerdem können noch für einige Exec-Speicher-Funktionen 
(AllocMem...) zusätzliche Bedingungen angegeben werden. 


Mögliche Attribute für Speicherblöcke 


Bit_ Name Funktion 

0 MEMF Public Speicherbereich nicht verschiebbar (Wichtig, immer angeben) 
I MEMF_Chip Speicherblock = Chip-RAM 

2 MEMF _Fast Speicherblock = Fast-RAM 

8 MEMF Local Speicherblock auf Motherboard (resetfest) [V37] 

9 MEMF 24BitDMA 24-Bit-Speicherblock (DMA-fähig, Zorroll/lll-Bereich) [V37] 

10 MEMF Kick Speicherbereich für "KickTag"-Funktionen (ab V39 immer 1) 
--- zusätzliche Bedingungen -—- 

16 MEMF Clear Speicherbereich vorher löschen 


17 MEMF Largest größten Speicherbereich suchen (AvailMem) 

18 MEMF Reverse Speicherbereich vom Ende anfangen zu suchen [ab V39 OK] 
19 MEMF Total gesamte Speichergröße ermitteln (AvailMem) 

31 MEMF No Expunge ab V39 - Bei Fehler (Guru) keine Behandlung 


Verwaltet werden die MemHeader-Listen nach ihrer Art (Chip,Fast, 
Local...), die über ihre NodelList-Strukturen verbunden sind. Jede Liste 
unterteilt dann noch seinen freien Bereich in Memory-Chunks ein. 
Durch das Multitasking kann ja ein Programm an jeder beliebigen 
Stelle im Speicher liegen und teilt somit den freien Speicherblock in 
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mindestens zwei Bereiche (Chunks) auf. Über die MemChunk- 
Strukturen merkt sich das System, welche Bereiche noch frei sind. Die 
Adresse des ersten freien Chunks wird in mh_First gespeichert. 


Au iner hunk- r (min. 1 
T F 
00  L mc_Next Adresse vom nächsten Chunk oder Null für Ende 
04  L mc_Bytes Größe des Chunks (Bereich) in Bytes 
08  -- ab hier folgt der freie Speicherbereich ---- 


Versucht ein Programm über das System Speicher zu reservieren, 
werden erst die Attribute der einzelnen MemHeader-Strukturen nach 
dem passenden Wert durchsucht. Danach wird mit mh_Free 
verglichen, ob der Bereich noch groß genug ist. Erst jetzt werden die 
einzelnen Chunks, den Bedingungen entsprechend, nach einem 
passenden Eintrag durchsucht und dieser reserviert, also die Anfangs- 
adresse des Chunks zurückgegeben. An der Adresse, die sich aus der 
alten MemChunk-Adresse und dem Offset aus der Differenz von der 
zu reservierenden Speichergröße und mc_Bytes ergibt, wird eine 
MemcChunk-Struktur eingefügt und mit der Liste verbunden, 


Routine: Allocate (FreeList,ByteSize) (A0O,DO) 
Offset: -186 
Parameter: AO = Zeiger auf eine Mem-Header-Struktur 
DO = Größe des Speicherblocks 
Rückgabe: =>DO=Adresse des Speicherblocks oder Null, wenn kein passender 
Speicherblock mehr frei ist. 
Erklärung: 
Allocate durchsucht die angegebene MemHeader-Struktur (AO) nach einen Speicher- 
block der gewünschten Größe (DO) und gibt bei Erfolg in DO die Anfangsadresse 
zurück, andernfalls eine Null für Fehler. Der betroffene Chunk wird entsprechend 
gekürzt bzw. entfernt. 
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Routine: DeAllocate (FreeList,MemoryBlock,ByteSize) (AD,A1,DO) 
Offset: -192 
Parameter: AO = Zeiger auf eine MemHeader-Struktur 

Al = Adresse des Speicherblocks (von Allocate) 

DO = Größe des Speicherblocks 


Erklärung: 
DeAllocate gibt den mit Allocate reservierten Speicherblock (Al) in angegebener Größe 


(DO) wieder frei und fügt den entsprechenden Chunk in die MemHeader-Struktur ein. 


Routine: AddMemtist (Size, Attributes,Pri,Base,Name) (DO,D1,D2,AO,A1) 
Offset: -618 (ab V33) 
Parameter: DO = Größe des gesamten Speicherbereichs (mh _Free) 

DI = Art des Speichers (Attribute) 

D2 = Priorität (z. B. Chip = -10, 16-Bit-RAM = 0) 

AO = Anfangsadresse des Speicherbereichs (mh_Lower) 

Al = Zeiger auf Namen (In_Name) - Name wird nicht kopiert 


oder Null, wenn kein Name eingetragen werden soll. 


Erklärung: 
AddMemlist fügt einen neuen Speicherbereich, der noch nicht eingebunden wurde, 


der Memmory-Liste hinzu. Es wird an den ersten Bytes eine MemHeader-Struktur 
erzeugt. Diese Funktion wird "eigentlich" nur vom System genutzt. 


Es gibt noch zwei weitere Funktionen, die eine flexiblere Speicherver- 
waltung ermöglichen. Mit AllocEntry () können mehrere Speicher- 
blöcke aufeinmal mit verschiedenen Attributen reserviert werden. 
Dazu wird eine Memlist-Struktur benötigt, die vorher mit den 
gewünschten Parametern initialisiert sein muß. 


Aufbau _ der Memlist-Struktur (min. 24 Bytes) 


T Name Funktion 
00 mi Node ListNode-Struktur 
14 W mi Numentries Anzahl MemEntry-Strukturen die folgen a 8 Bytes 
16 --- ab hier folgen die einzelnen MemEntry-Strukturen -- 


Aufbau einer MemEntry-Struktur (8 Bytes) 


T Name Funktion 
00°  L me Reqgs/me Addr Art des Speichers (Attribute) 
08 L me Length Größe des Speichers in Bytes 
Ende 
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Der me_Regs-Eintrag enthält die Bedingungen für den zu reservier- 
enden Speicher. Nach Aufruf der Funktion enthält me_Regs die 
Adresse des Speicherblocks (me_Addr). 


Beispiel für Reservieren von drei icherblöcken: 


lea MemList,AO ; MemList-Struktur 
move.| 4,36 
jsr -222(a6) ; AllocEntry () 
btst #31,d0 ; Fehler ? 
bne Error 
MemList: 
bik.b 14,0 ; 14 Bytes für ListNode 
dc.w 3 ; Anzahl MemEntry-Strukturen 
dc.| 510003 ; me_Regs!: Clear + Chip + Public 
de.l 4096 ; me_Lengthl: 4 KByte 
de. $10005 ; me_Reags2: Clear + Fast + Public 
dc.l 8192 ; me_Length2: 8 KByte 
dc.l $10001 ; me _Regs3: Clear + Public 
dc.l 1024 ; me_Length3: 1 KByte 


Routine: AllocEntry (Entry) (AO) 
-222 


Offset: 
Parameter: AO = Zeiger auf eine init. Memlist-Struktur 
Rückgabe: =>DO=Adresse der Memlist und Bit 31 = O (OK) oder wenn 


Bit 31 = 1, die Attribute des Speicherblocks (Fehler) 

Erklärung: 

AllocEntry reserviert für alle angegebenen Attribute die dazugehörigen Speicherblöcke. 
Tritt ein Fehler auf, werden in DO das Bit 31 und die Attribute des fehlerhaften 
Speicherblocks gesetzt. Alle bis dahin reservierten Speicherblöcke werden wieder 
freigegeben. Ansonsten enthält DO die Adresse der MemList-Struktur und Bit 31 ist 
gelöscht. Alle me _Reqs-Einträge enthalten jetzt die Anfangsadressen der Speicher- 
blöcke (me Regqs => me _Addr). 


Routine: FreeEntry (Entry) (AO) 

Offset: -228 

Parameter: AO = Zeiger auf eine MemList-Struktur (mit me _Addr-Einträge) 
Erklärung: 

FreeEntry gibt die Speicherblöcke, welche zuvor mit AllocEntry reserviert wurden, 
wieder frei. 
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13.7.1 Die Exec-Speicherfunktionen 


Die bisher beschriebenen Funktionen benötigen immer aufwendige 
Strukturen, die teilweise auch noch initialisiert werden müssen. Exec 
bietet aber noch andere Funktionen mit denen man schnell und 
einfach Speicher verwalten kann. 


Routine: AllocMem (ByteSize,Requirements) (DO,D1) 
Offset: -198 
Parameter: DO = Größe des Speicherblocks 

D1 = Bedingungen des Speichers (Attribute) 
Rückgabe: = >DO=Adresse des Speicherblocks oder Null (Fehler) 
Erklärung: 
AllocMem reserviert einen beliebigen Speicherblock und gibt die Adresse in DO zurück. 
Wenn kein passender Speicherblock mehr zur Verfügung steht, ist DO gelöscht. Bei den 
Bedingungen (D1) sollten Sie unbedingt immer MEMF Public setzen, weil sich sonst 
die seltsamsten Dinge ergeben könnten. 


|. —.— |. | | | | |. ne ee ne nn m — — 


Routine: FreeMem (MemoryBlock,ByteSize) (A1,DO) 
Offset: -210 
Parameter: AI = Adresse des Speicherblocks (Ergebnis von AllocMem) 
DO = Größe des Speicherblocks 
Erklärung: 
FreeMem gibt den mit AllocMem reservierten Speicherblock wieder frei. Die Größe 
muß die gleiche, wie bei AllocMem sein. 


Seit der Version V36 enthält Exec zwei neue Funktionen, mit denen 
der Speicher noch einfacher verwaltet werden kann. Es entfällt dann 
das lästige Merken der Speichergröße für das Freigeben des Speicher- 
blocks. 


Routine: AllocVec (ByteSize,‚Attributes) (DO,D1) 
Offset: -684 (V36) 
Parameter: DO = Größe des Speicherblocks 
D1 = Speicherbedingungen (Attribute) 
Rückgabe: =>DO=Adresse des Speicherblocks oder Null (Fehler) 
Erklärung: 


Die gleiche Funktion wie AllocMem, allerdings wird die Speichergröße gesichert. 
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Routine: FreeVec (MemoryBlock) (A1) 

Offset: -690 (V36) 

Parameter: A1 = Adresse des Speicherblocks (von AllocVec) 
Erklärung: 


Die gleiche Funktion wie FreeMem. Es muß aber keine Größe mehr übergeben 
werden. Diese hat sich das System vorher gemerkt. 


Beschreibung weiterer Exec-Speicherfunktionen 


Routine: AllocAbs (ByteSize,Location) (DO,A1) 
Offset: -204 
Parameter: DO = Größe des Speicherblocks 


Al = Adresse des Speicherblocks 
Rückgabe: =>DO=Adresse des Speicherblocks (wie A1) oder Null (Fehler) 
Erklärung: 
Mit AllocAbs kann ein vom Programmierer definierter Speicherbereich reserviert 
werden. Ist der Speicherblock nicht mehr frei, wird in DO eine Null zurückgegeben, 
andernfalls enthält DO die Adresse des Speicherblocks, welche wir zuvor in Al 
übergeben hatten. Den Speicher kann man nur mit FreeMem () zurückgeben. 


Routine: TypeOfMem (Adress) (A1) 
-534 


Offset: 

Parameter: AI = Adresse eines Speicherblocks bzw. irgend eine Adresse 
Rückgabe: = >DO=Attribute der Speicheradresse oder Null für Fehler 
Erklärung: 


TypOfMem ermittelt die Art (Attribute) einer Speicheradresse. Befindet sich die Adresse 
z. B. in einem ROM-Bereich, wird eine Null zurückgegeben. 


en a u —_— —— 


Routine: CopyMem (Source ‚Dest,Size) (A0O,A1,DO) 

Offset: -624 (V36) 

Parameter: AO = Adresse des Quell-Speicherbereichs 
Al = Adresse des Ziel-Speicherbereichs 
DO = Anzahl Bytes 


Erklärung: 

CopyMem kopiert Daten von einem Speicherbereich (AO) in einen anderen (Al). Die 
Anzahl Daten wird in DO angegeben. Zu beachten ist, daß sich die Bereiche nicht 
überschneiden dürfen. Während dem Kopiervorgang werden die Caches einer CPU 
deaktiviert, also nicht zwischengespeichert. 


en nn nn 
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Routine: CopyMemQuick (Source ,Dest,Size) (A0D,A1,DO) 

Offset: -630 (V36) 

Parameter: AO = Adresse des Quell-Speicherbereichs (durch 4 teilbar) 
Al = Adresse des Ziel-Speicherbereichs (durch 4 teilbar) 
DO = Anzahl Bytes (durch 4 teilbar) 


Erklärung: 

CopyMemQuick hat die gleiche Funktion wie CopyMem. Sie wurde extra für Long- 
words optimiert. Das heißt, daß die Adressen und die Länge durch vier teilbar sein 
müssen. 


13.8 Ein- u. Ausgabe auf dem Amiga 


In Kapitel 5 sind wir schon einmal auf ein Device eingegangen. Es 
handelt sich dabei um Programmpackete, die bestimmte Ein- und 
Ausgabeaufgaben, ohne Umgehung des Multitasking, erledigen. 
Dafür benötigen wir eine IO-Request-Struktur und evtl. je nach 
Aufgabenstellung noch eine Erweiterung (lOStdRedg). 


Die lORequest-Struktur enthält am Anfang eine Message-Struktur, 
wobei es sich bei den ersten 14 Bytes wieder um eine ListNode- 
Struktur handelt, über die die Strukturen verbunden sind. Der 
In_Type ist NT_DEVICE und In_Name enthält einen Zeiger auf den 
Namen des Device. Der ReplyPort (Offset 14) ist notwendig, damit 
das System den Abschluß einer Nachricht (Kommando) erkennt. Der 
Der mn_Length-Eintrag enthält die Länge der eigentlichen Message- 
Daten, die direkt im Anschluß folgen (siehe Abschnitt 13.6). 


Aufbau der IO-Request-Struktur (48 Bytes) 


Offset Typ Name Funktion 

00 1  Succ Adresse der nachfolgenden MsgNode-Struktur oder Null 
04  L Pred Adresse der vorherigen MsgNode-Struktur oder Null 

08 B Type Eintragstyp (hier Device = > 3) 

09 B Phi Priorität dieser Struktur 

10 L Name Zeiger auf Namen dieser Struktur 
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L ReplyPort Adresse des ReplyPorts (selber eintragen) 
18 _\W MNLength Länge der folgenden Message-Daten (38 Bytes) 
.-uunknen nenn normale Device-Befehle ------------------ = 


20  L 10 Device Zeiger auf DeviceNode (wird durch OpenDevice () eingetr.) 
24  L IO_Unit Einheitsnummer (Abhängig vom Device) 

28 \ IO Command Befehl für das Device 

30 B IO Flags Flags (Abhängig vom Device) 

31 B IO Error Error-Rückmeldung nach der Durchführung eines Befehls 
———— une Standard IO-Request-Erweiterung ------------------ 
32  L 10 _Actual Anzahl der tatsächlich übertragenden Bytes vom Device 

36 L 1IO Length Anzahl der zu übertragenden Bytes 

40 L IO Data Adresse des Speicherbereichs, wo die Daten vom Device 


gespeichert werden sollen 
44 L IO Offset Datenoffset (Abhängig vom Device) 


48 _ Hier beginnt evtl. eine Erweiterung der Struktur (Abhängig vom Device und 
den Befehlen) oder die Struktur ist hier zuende. 


Der Eintrag IO_Device zeigt auf eine Device-Struktur, die den 
gleichen Aufbau, wie eine Library besitzt. Über die Basis-Befehle 
werden dann die jeweiligen Funktionen aufgerufen. 


Basis-Befehle eines Device: 


F 

CMD Invalid O0 ungültiges Kommando 

CMD_Reset 1 Device zurücksetzen auf Anfangszustand 

CMD Read 2 Device ließt Daten in den Datenpuffer (IO_ Data) 

CMD Write 3 Device schreibt die Daten auf die IO_Data zeigt auf das ent- 
sprechende Gerät 


CMD Update 4 restaurieren des Datenpuffers 

CMD Clear 5 Datenpuffer löschen 

CMD_Stop 6 letzten Device-Befehl anhalten 
CMD Start 7 Device-Befehl wieder fortsetzen 
CMD Flush 8 Abbruch des letzten Device-Befehls 


..——...—.—nnnmunelkemsnmmannnnennmunnmenmenmunntsen—nun nm nn enen nn nun en nm—n mm nnm— nn nn num nn nn u nn nn mn nn ann nun nn m—n nenn nn 


Kommunizieren kann unser Task mit einem Device nur über seinen 
ReplyPort, den wir in die IORequest-Struktur (Offset 14) eintragen 
müssen. Die Exec-Funktion FindTask (Al=0) ermittellt die Adresse 
von unserer Task- bzw. Process-Struktur, welche wir in unserem 
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eigenen Port (34 Bytes) eintragen (Offset 16 => mp SigTask). Den 
ReplyPort fügen wir mit AddPort () der Systemliste hinzu und können 
jetzt über ihn mit dem Device Daten austauschen. 


Devices gibt es für alle möglichen Aufgaben. Genau wie die Libraries, 
existieren externe im Devs-Verzeichnis und interne im ROM. Geöffnet 
wird ein Device mit der Funktion OpenDevice () und geschlossen mit 
CloseDevice (). 


Routine: OpenDevice (DevName,Unit,IORequest,Flags) (ADO,DO,A1,D1) 
Offset: -444 
Parameter: AO = Zeiger auf DeviceName 

DO = Unit-Nummer (Abhängig vom Device, meistens Null) 


Al = Zeiger auf eine IORequest-Struktur 
DI = Flags (Abhängig vom Device, meistens Null) 
Rückgabe: =>DO=Null, dann OK - sonst Fehlernummer (-1) 


Erklärung: 
OpenDevice öffnet ein Device (extern o. intern) und ermöglicht den Datenaustausch 


von Task und Device über eine IORequest-Struktur (Al). Wichtig ist, das Sie vor der 
Kommunikation einen Message-Port anlegen (AddPort). 


Routine: CloseDevice (IORequest) (A1) 

Offset: -450 

Parameter: AI = Zeiger auf eine IORequest-Struktur 
Erklärung: 


CloseDevice schließt eine Device wieder und gibt den belegten Speicher zurück. Der 
zuvor angelegte Message-Port (ReplyPort) sollte auch entfernt werden (RemPort). 


13.8.1 IO-Funktionen von Exec 


Der Datenaustausch mit einem Device läuft über Message-Ports, also 
über Signale, die unseren Task das Ende eines Device-Befehls mit- 
teilen. Hierfür bietet Exec spezielle Funktionen, mit denen wir die 
Signale austauschen können. 
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Routine: DoIO (IORequest) (Al) 

Offset: -456 

Parameter: A1 = Zeiger auf eine IORequest-Struktur (mit ReplyPort) 
Rückgabe: = >DO= Wert des IO_Error-Feldes 

Erklärung: 


DoIO sendet einen Befehl an das entsprechende Device (lO_Device). Der Task wird 
solange in die Waitliste eingetragen, bis der Befehl ausgeführt wurde. Der gesamte 
Message-Vorgang läuft vollautomatisch ab. 


Routine: SendiO (IORequest) (A1) 

Offset: -462 

Parameter: A1 = Zeiger auf eine IORequest-Struktur (mit ReplyPort) 

Erklärung: 

SendiO sendet einen Befehl an das entsprechende Device (IO_ Device). Der Task muß 
aber nicht auf die Beendigung warten. 


Routine: ChecklO (IORequest) (A1) 


Offset: -468 

Parameter: A1 = Zeiger auf eine IORequest-Struktur (mit ReplyPort) 
Rückgabe: = > DO=1ORequest-Struktur oder Null, wenn noch nicht fertig 
Erklärung: 


ChecklO prüft den letzten Device-Befehl, der mit SendIO gesendet wurde, auf dessen 
Beendigung. Das Datenregister DO enthält die Adresse der IORequest-Struktur, wenn 
alles abgearbeitet wurde (keine Message mehr), andernfalls eine Null. 


EEE Te Tee ee Te ee ee ee ee ee ze ee a ee 


Routine: WaitlO (IORequest) (Al) 
Offset: -474 

Parameter: A1 = Zeiger auf eine |ORequest-Struktur (mit ReplyPort) 

Erklärung: 

WaitlO wartet auf die Beendigung des letzten Device-Befehls (SendiO). Der Task wird 
solange in die Waitliste eingetragen. In Verbindung mit SendiO ergibt WaitlO die 
Funktion DoIO (). 


Eh 


Routine: AbortiO (IORequest) (Al) 

Offset: -480 

Parameter: A1 = Zeiger auf eine IORequest-Struktur (mit ReplyPort) 
Erklärung: 


AbortiO unterbricht den letzten laufenden Device-Befehl. 
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13.9 Interrupts über Exec 


Der Amiga kennt 14 verschiedene Interrupts. Die Rangfolge wird be- 
stimmt durch ihre Pseudopriorität. Der Interruptablauf wurde bereits 
in Kapitel 1 behandelt. Exec bietet natürlich auch wieder Funktionen 
und Strukturen für den Umgang mit Interrupts. 


In der Execbase ist, ab Offset 84, für jeden Interrupt ein Vektor 


vorhanden (IntVector-Struktur). Dieser besteht aus drei Longwords 
und hat folgenden Aufbau: 


Aufbau der IntVector-Struktur (12 Bytes) 


Offset T Na Funktion 

00° L iv Data Zeiger auf Datenspeicher (Handler) oder ServerList (Server) 
04 °  L iv Code Zeiger auf IRQ-Programm (Handler oder Server) 

08 L iv Node Zeiger auf Node der ersten Interrupt-Struktur (Handler) 


oder Null bei Server 
12 Ende 


Exec bietet die Möglichkeit einen Interrupt auf zwei Arten zu 
verwalten. Entweder als Interrupt-Handler, dann enthält iv_Data 
einen Zeiger auf einen Datenpuffer, iv_ Code die Adresse des Inter- 
ruptprogramms und iv_Node den Zeiger auf die ListNode-Struktur 
der dazugehörigen Interrupt-Struktur. Oder als Interrupt-Server, der 
mehrere Programme verwalten kann. Als Kennzeichnung enthält 
iv_ Node den Wert Null, iv_Data einen Zeiger auf eine ServerList- 
Struktur und iv_Code die Adresse des Interrupt-Server-Programms. 


Der Unterschied zwischen einem Handler und Server ist, daß der 
Handler bei einem Interrupt immer nur ein Programm ausführt auf 
das iv_Code zeigt. Beim Server werden alle Programme in Abhängig- 
keit der Priorität, die in der Liste der ServerList-Struktur (iv_Data) 
verbunden sind, ausgeführt. Sie als Benutzer können auch nur ein 
Programm über den Server verwalten. 
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Nach dem Systemstart sind die Interrupt-Vektoren PORTS, COPER, 
VERTB, EXTER und NMI als Server initialisiert, die restlichen als 
Interrupt-Handler. 


Ein Handler- oder Server-Programm muß immer mit einem RTS 
enden. Die Register DO, D1, AO, Al, A5 und A6 können frei genutzt 
werden und müssen nicht beim Verlassen den gleichen Wert wie am 
Anfang enthalten. Für einen Handler bzw. Server enthalten die 
Register folgende Werte: 


Registerwerte vor einem Handleraufruf: 


DO = unwichtige Daten 
DI = UND-Verknüpfung von INTENAR und INTREQR 
AO = Custom-Chip-Adresse ($DFFOOO) 
Ai = Wert von is_Data (Adresse des Datenpuffers) 
A5 = Wert von is_Code (Adresse des Handler-Programms) 
A6 = ExecBase-Adresse (SysBase) 
Registerwerte vor einem Serveraufruf: 
DO = unbestimmter Wert 
D1 = unbestimmter Wert 
AO = unbestimmter Wert, evtl. auf $DFFOOO setzen 
Al = Wert von is_Data (Adresse des Datenpuffers) 
A5 = Wert von is_Code (Adresse des Server-Programms) 
A6 = unbestimmter Wert 


Da über den Server alle Programme in der Serverliste nacheinander 
aufgerufen werden, weil Exec nicht erkennen kann, für wenn jetzt der 
Interrupt bestimmt ist, kann man über das Z-Flag die Serveraufrufe 
beenden. Dazu muß das entsprechende Programm am Ende das Z- 
Flag nur löschen und es folgt kein weiterer Serveraufruf. 
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Beispiel zum Setzen des Z-Flags (weitere Serveraufufe): 


movegq #0,d0 
rts ; Serverprogramm beenden 


Beispiel zum Löschen des Z-Flags (keine weiteren Serveraufufe): 


moveqg #1,d0 
rts ;‚ Serverprogramm beenden 


13.9.1 Die Interrupt-Funktionen 


Für das Verwalten von Handlern und Servern stellt uns Exec ver- 
schiedene Funktionen bereit. Mit SetintVector () wird ein Interrupt- 
Vektor für einen Handler initialisert und kann nicht mehr entfernt 
werden. Einen Server kann man durch die Funktion AddIntServer () 
der Serverliste hinzufügen und mit RemintServer () wieder entfernen. 


Es gibt noch eine vierte Funktion für die Software-Interrupts. Mit der 
Funktion Cause () wird ein solcher Interrupt ausgelöst. Ein Software- 
Interrupt besitzt eine höhere Priorität als Tasks, aber eine niedrigere 
als die Hardware-Interrupts. Sie können auch automatisch durch ein 
Task-Signal ausgelöst werden (siehe vorherige Abschnitte). In der 
Execbase ab Offset 434 ist Platz für 5 Software-Interrupt-List-Header- 
Strukturen (jeweils 16 Bytes). Deswegen sind die 5 Prioritäten festge- 
legt und wählbar in 16er Schritten (-32, -16, O, 16, 32). 


Alle Funktionen benötigen zur Initialisierung des Interrupt-Vektors 
eine Interrupt-Struktur, in der alle wichtigen Werte vor dem Aufruf 
enthalten sein müssen. Die Daten in der Struktur werden dann als 
Handler- oder Server-Parameter eingesetzt, je nachdem welche 
Funktion aufgerufen wurde. 
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Aufbau _der Interrupt-Struktur (22 Bytes) 


T nkti 
00 is Node ListNode-Struktur (In_Type = NT_INTERRUPT und 
In Name = Zeiger auf IRQ-Namen - Wichtig) 
14  L is Data Zeiger auf Datenpuffer für is Code 
» 4 is Code Zeiger auf IRQ-Programm 
22 Ende 


Exec-Funktionen für Interrupt-Verwaltung 


Routine: SetintVector (IntNumber,‚Interrupt) (DO,A1) 
Offset: -162 
Parameter: DO = Interruptnummer (0 bis 14) 
Al = Zeiger auf eine init. Interrupt-Struktur 
Rückgabe: =>DO= Adresse der alten Interrupt-Struktur 
Erklärung: 
SetintVektor initialisiert einen Interrupt-Vektor als Handler. Wenn Sie Ihr Programm 
verlassen, sollten Sie den alten Handler (Rückgabe DO) wieder eintragen. 


ee ee nn 


Routine: AddintServer (IntNumber,Interrupt) (DO,A1) 
Offset: -168 
Parameter: DO = Interruptnummer (0 bis 14) 
Al = Zeiger auf eine init. Interrupt-Struktur 
Erklärung: 
AddintServer initialisert einen Interrupt-Vektor als Server. Die Priorität in In_Pri 
bestimmt die Position innerhalb der Liste. 


— 


Routine: RemintServer (IntNumber ‚Interrupt) (DO,A1) 
Offset: -174 
Parameter: DO = Interruptnummer (0 bis 14) 


Al = Zeiger auf eine init. Interrupt-Struktur 


Erklärung: 
Remint$erver entfernt einen IRQ-Server wieder aus der Serverliste. 


ee u | eu —— 


Routine: Cause (Interrupt) (Al) 

Offset: -180 

Parameter: AI = Zeiger auf eine init. Interrupt-Struktur für Software-IRQs 
Erklärung: 

Cause erzeugt einen Software-Interrupt und unterbricht den aktiven Task. Ein Software- 
IRQ kann auch durch ein Task-Signal oder einem Hardware-IRQ ausgelöst werden. Die 
Priorität kann dabei nur die Werte -32, -16, 0, 16, 32 annehmen. 
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13.9.2 Beispielinterruptprogramm 


Das folgende Beispiel fügt eine Server-Interrupt-Routine der Vertikal- 
Blank-Serverliste hinzu. In 500ms-Takt blinkt die Power-LED. Sobald 
die rechte Maustaste gedrückt wird, entfernt das Programm den 
Server wieder und beendet sich. 


se a cn _  . —_—— 


;--- VertikalBlank-Server ns 
;--- Power-LED blink in 500ms-Abstand --- 
;--- rechte Maustaste = Ende vom Prg. -_-- 


u m... nn nn nn nn m m m u m m m m m = — oo  —-  —_ 


lea Interrupt,al ; init. Interrupt-Struktur 
moveq #5,d0 ; IntNumber = VertB 
move.l 4,36 
jsr -168(a6) ; AddIntServer () 

Wait: 
btst #10,$dff016 ; rechte Maustaste ? 
bne Wait 
lea Interrupt,al ; init. Interrupt-Struktur 
movegq #5,d0 ; IntNumber = VertB 
move.| 4,36 
jsr -174(a6) ; RemintServer () 
rts ; Programmende 

;--- Interrupt-Programm (Server) --- 

ıs Code 


add.w #1,Counter 
move.w Counter,dO 
cmp.w  #25,d0 


blo ıs Code End 
cir.w Counter 
bchg.b #1,$bfe001 
is Code _End: 
moveq #0,d0 ; kein nächster Server (Z=1) 
rts 


Counter: dc.w O 
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Interrupt: 


dc.1 0,0 ; In_Succ,In_Pred 

dc.b 2 ; In Type = NT_INTERRUPT 
dc.b 10 ; In_Pri = 10 

dc.| In _ Name 

dc.l is Data ; Zeiger auf Daten für Server 
dc.| is_ Code ; Zeiger auf Server-Programm 


is_Data: bik.b 1024,0 


In_Name: dc.b "VertikalBlank-LED",O 
even 


13.10 resetfeste Programme 


Zum Abschluß des Kapitels wollen wir noch ein wenig den Reset- 
Vorgang erläutern. Beginnen wir mit dem Auslösen eines Resets. 


Seit der Exec-Version 36 können wir über die Funktion ColdReboot () 
einen Reset auslösen. Sind Sie Besitzer einer älteren Version, dann 
wird es nicht nur Zeit sich das 0S3.1 zuzulegen, sondern der Reset- 
Aufruf erfordert auch ein wenig mehr Arbeit. Wir müssen dann die 
Adresse der internen Reset-Routine selbst berechnen. 


Das folgende Listing demonstriert einen Reset für alle Kickstart- 
Versionen. Es handelt sich dabei um die von Commodore empfohlene 
Reset-Routine. 


ee |  — — —_—  — ——— u —  —  ..o..— 


move.| 4,36 


cmp.w #36,34(a6) ; Version < 36 ? 
bit Old Exec 
jmp -726(a6) ; ColdReboot () 
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Old Exec: 

lea OldReset,a5 ; alte Reset-Routine 

jsr -30(a6) ; SuperVisor () 

cnop 0,4 ; Wichtig, damit Adresse durch 4 teilbar 
OldReset: 

lea $1000000,a0 ; Ende des Kickstart-ROM 

sub.! -20(a0),a0 ; ROM Offset (KickSize abziehen) 

move.l 4(a0),a0 ; Einsprung für PC 

subq.|l  #2,a0 ; Zeigt auf Reset 

reset ; die folgenden Befehle 

jmp (a0) ; nicht verändern 


Das nächste Beispiel demonstriert das Initialisieren von resetfesten 
Programmen. Hierfür stehen uns zwei Möglichkeiten zur Auswahl. 
Entweder tragen wir unser Programm in den Cold- oder CoolCapture 
der ExecBase ein (Offset 42, 46). Das Programm im ColdCapture wird 
schon recht früh ausgeführt. Das System ist zu diesem Zeitpunkt fast 
noch überhaupt nicht initialisiert. Auch der Stackpointer enthält noch 
nicht die korekte Adresse. Deswegen wird die Rücksprungadresse für 
das ColdCapture-Programm in A5 übergeben. Ihr Programm sollte 
also mit einem "jmp (a5)" enden. 


Das Programm im CoolCapture wird erst nach der kompletten Initiali- 
sierung des Systems mit einem "JSR" aufgerufen. Unser Reset-Pro- 
gramm muß dann mit einem "RTS" enden. 


Soblad wir den unteren Bereich der ExecBase ändern, müssen wir die 
Checksummen neu berechnen. Für den ColdCapture wird die 
Checksumme über die ersten 23 Words ab Offset 34 berechnet und 
in ChkSum (Offset 82) eingetragen. Der CoolCapture berechnet seine 
Checksumme über die ersten 25 Words ab Offset 34 und trägt sie in 
LowMemcChkSum ein. 


Die Berechnung der Chechsumme läuft immer gleich ab. Nur die 
Anzahl Words und wo das Ergebnis eingetragen wird, variiert. 
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Das folgende Beispiel trägt ein Reset-Programm in den CoolCapture 
und berechnet die Prüfsumme. Nach einem Reset fängt der 
Bildschirm an zu blincken. Durch drücken der rechten Maustaste läuft 
der Reset-Vorgang weiter. 


;--- Hauptprogramm zum init. des CoolCapture --- 
bsr InitCoolCapture 
rts 
;--- eigenes CooCaptureProgramm --- 
CoolStart: ; Anfang vom CoolCapturePrg. 
movem.l dO-a6,-(sp) 
bsr InitCoolCapture 


;—- ab hier eigene Routinen --- 


Wait: 


move.w $dff006,$dff180 
btst #10,$dff016 ‚ rechte Maustaste ? 
bne Wait 
movem.| (sp)+ ‚dO-a6 
rts 
;--- CoolCapturePrg init. --- 


InitCoolCapture: 
move.l  #CoolEnd-CoolStart,dO 
move.|l #$10001,d1 
move.| 4,36 


jsr -198(a6) ; AllocMem () 
tst.| dO 
beq ICC_End 
CopyCoolPrg: 
move.|l dO,a0 
lea CoolStart(pc),a1 
move.| a1,46(a6) ; CoolCapture 
move.l #CoolEnd-CoolStart,dO ; Länge CoolCapturePrg. 
CoolCopy: 
move.b (al)+,(a0)+ 
suba.| #1,d0 


bne CoolCopy 
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;-- LowMemchkSum berechnen --- 


moveq #0,d1 

move.w d1,36(a6) ; LowMemcChkSum 

lea 34(a6),a0 

movegq #24,d0 ; 25 Words (-1, wegen dbra) 
CheckLoop: 


add.w (a0)+,d1 
dbra dO,CheckLoop 


not.W di 

move.w d1,36(a6) ; LowMemcheckSum eintragen 
ICC_End: 

rts 
CoolEnd: ; Ende vom CoolCapturePrg. 
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14. Die Lowlevel-Library 


Die LowLlevel-Library ist hauptsächlich für Spieleprogrammierer 
entwickelt worden. Sie wird ab der Workbench 3.1 mitgeliefert und 
bietet eine Menge Funktionen zur systemkonformen Entwicklung von 
Spielen, ohne Geschwindigkeitseinbußen. 


Das Problem war, bis zur Einführung der LowLevel-Library, daß sich 
professionelle, besonders schnelle Spiele nicht über das System 
programmieren ließen. Es mußte schon direkt die Hardware 
angesprochen werden. Dieses führte zu vielen Problemen, wie keine 
DOS-Operationen mehr möglich, eigene Speichereinteilung usw.. Mit 
der LowLevel-Library ist man jetzt endlich in der Lage, alles was zur 
Spieleprogrammierung notwendig ist, über das System zu program- 
mieren, ohne Geschwindigkeitsverlust und die wichtigsten DOS- 
Funktionen bleiben auch erhalten (Laden von Festplatte). 


14.1 Die LowLevel-Funktionen 


In der Version 40 der LowLevel-Library, wie sie mit der \WB3.1 
mitgeliefert wird, gibt es 15 Funktionen die sich mit der "direkten" 
systemkonformen Hardwareprogrammierung befassen, Diese lassen 
sich grob in drei Bereiche gliedern: 


]) allgemeine System-[Multitasking-) Funktionen 
2) Abfrage-Funktionen (loystick, Maus, Gamekontroller) 
I) Interrupt-Funktionen 


1) allgemeine System-(Multitasking) Funktionen 


Mit diesen Funktionen läßt sich das Multitasking beeinflussen 
(ausschalten), die Sprache auslesen und das Eingabegerät installieren. 
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Die erste und wohl wichtigste Routine ist die Funktion "System- 
ControlA ()". Hiermit läßt sich das Multitasking Ein- und Ausschalten. 
Um nicht jede Funktion so umständlich und unübersichtlich 
beschreiben zu müssen, folgt eine Kurzbeschreibung aller LowLevel- 
Routinen mit den dazugehörigen Parametern und Beispielen. 


Routine:  SystemControlA [Tagtlıist) (Al) 


Library: Iowlevel.library 

Offset: -72 

Parameter: Al = TagList, welche die Parameter für diese Funktion 
enthält. 


Rückgabe: DO = (FailTag) => Null, wenn alle Tags angewendet 
werden konnten. 
= <0> => Fehler (bei ungleich Null) 
Erklärung: Diese Funktion beeinflußt das System entsprechend der 
übergebenen Parameter auf die Al zeigt. 


Parameter für SystemControflA _(): 


Bezeichnung Wert ___Funktion 
SCON _TakeOverSys -1(True) Multitasking ausschalten und das eigene Programm be- 
($80C00000) kommt fast alle Taktzyklen zugeteilt. 

O(False) Multitasking wieder einschalten 
SCON KillReq -1(True) alle evtl. auftretenden Requester unterdrücken 
(#80C00001) O(False) Requester wieder erlauben 
SCON CDReboot 0  (CDReboot_Off) => Wechseln von CDs erlaubt, ohne 
(#80C00002) das ein Reset ausgeführt wird (nur für CD32). 


1 (CDReboot_ On) => Beim Öffnen der CD32-Klappe wird 
ein Reset ausgelöst (nur für CD32). 


2  (CDReboot Default) => alten CD32-Zustand wieder- 
herstellen. Immer setzen, wenn ein Programm verlassen 
wird, worin der Wert vorher geändert wurde. 

SCON StopInput -I(True) Auf das "input.device" verzichten. Bringt noch mehr 

(#80C00003) Rechenzeit, kann aber nicht wieder Rückgängig gemacht 
werden. Jetzt müssen Sie die Tastatur bzw. die Game- 
Ports selber abfragen. 


————mm—mem—m—memmmmmtmmeu En nm nn un nun ns m mann nn nun - 
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SCON _AddCreatekeys 0-3 Vom GamePort X (0 bis 3) alle Signale zusätzlich in 

($80C00004) RawKey-Codes wandeln. Dadurch läßt sich mit der 
Funktion "GetKey ()" und "QueryKeys ()" die Tastatur u. 
die GamePorts abfragen. 


SCON RemCreateKkeys 0-3 Für GamePort X (0 bis 3) werden die Signale nicht mehr 
($80C00005) in RawKey-Codes gewandelt. 


Möchte man das System ausschalten und für GamePort 1 die Signale 
in RawKey-Codes wandeln lassen, so könnte das in Assembler so 
aussehen: 


INCLUDE "Includes/libraries/lowlevel.i" 


move.| LowLevelBase,a6 
lea TagList1,al 


jsr -72(a6) ‚ SystemControlA () 
tst. do 
bne Error 

TagList!: 


dc.| SCON TakeOverSys, True 
dc.| SCON_AddCreatekKeys, 1 
dc! TAG_DONE 


Wenn Sie keine Includes verwenden möchten, können Sie die TaglList 
auch so übergeben: 


TagList!: 
dc. $80C00000,-1 ; SCON_TakeOverSys,True 
dc. $80C00004,1 ; SCON AddCreateKeys,Port! 
del 0 ; TAG_DONE 
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Routine: Getlanguageselection ( 

Library: Iowlevel.library 

Offset: -36 

Parameter: keine 

Rückgabe: DO = Wert zwischen 1 und 18, der für die eingestellte 
Sprache steht oder 0, wenn Sprache nicht bekannt 
bzw. noch nicht initialisiert. 

Erklärung: Ermittlet die eingestellte Sprache des Systems. 


Werte für Sprachen: 


Wert Land Wert Land Wert Land 
00 unbekannt 06 Italien 12 Schweden 
01 USA 07 Portugal 13 Japan 
02 England 08 Dänemark 14 China 
03 Deutschland 09 Niederlande 15 Arabien 
04 Frankreich 10 Norwegen 16 Griechenland 
05 Spanien 11 Finnland 17 Israel 
18 Korea 


Routine:  Sey/oyPortAttsA (DO.A1) (PortNumber, Taglıst) 

Library: Iowlevel.library 

Offset: -132 

Parameter: DO = Numme des GamePorts (0 bis 3) für diese Funktion 
Al = Liste mit Parametern für diese Funktion 

Rückgabe: DO = -I(True), wenn alles O.K., sonst O(False) für Fehler 

Erklärung: Legt für den angegeben Port das Eingabegerät fest. Das 
System übermittelt dann nur noch für dieses Gerät, über 
die Funktion "ReadjJoyPort ()", die aktuellen Werte. 
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Parameter für die TagList der Funktion_"SetloyPortAttrsA_": 


Bezeichnung Wert __ Funktion 
SJA_Type 0 automatische Festlegung des Eingabegerätes (System) 
($80C00101) bekommt fast alle Taktzyklen zugeteilt. 


1 Gerät als GameController (CD32-JoyPad) festlegen 
2 Maus als Eingabegerät definieren 
3 Joystick ales Eingabegerät definieren 


- —— ,—— || nm |nhiumuuknihthzennnn—m m ninnnnnnntnnmnnn neun nn nn mn nem nn nn men nen mn nu mn nen en nme n an nn nm en nme nun nme nn nn men ann nun 


SJA_Reinitialize 0 Funktion wieder Rückgängig machen (alten Port setzen) 
($80C00102) 
2) Abfrage-Funktionen 


Der zweite Bereich sind die Funktionen für das Abfragen der 
Eingabegeräte, wie Tastatur, Maus, Joystick usw. 


Routine: ReadjoyPort (DO) (PortNumber) 
Library: lowlevel.library 

Offset: -30 
Parameter: DO 


Nummer des GamePorts (0 bis 3) welcher ausge- 

lesen werden sollen. 

Rückgabe: DO = (PortState) => Status des Eingabegerätes. 

Erklärung: Ließt den aktuellen Status des GamePort X ein. Das Ein- 
gabegerät kann und sollte auch vorher festgelegt werden 
(siehe SetJoyPortAttrsA ()". 


Aurbau_des Rückgabewertes (Status): 


Bits: 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 
-Mask-Typ- 0 0 00 mm Buttons-------- 0 
Joy/Pad: 2008 08008 OS BUDLR 
Bits: 15 14 13 12 11 100908 07 06 05 04 03 02 01 00 
Maus: —— @mmmm rel.YPos. der Maus------ —---[e],XPos. der Maus------ 


.—————| | | |mumtnmtunnmnntnemutmnmnmuus un nenn nmnn en npmnienmnmunnunn nn nen nn nn nn nenn nen nn nn ns nn nn 
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Beschreibung der einzelnen Bits: 


Die Bits 28 bis 31 (4 Bit) geben darüber Auskunft was für ein Einga- 
begerät eingestellt ist: 


31 30 29 28 Wert Funktion 

0 0 0 0 0 Port im Moment nicht ansprechbar, weil diese Funktion 
immer nur von einem Programm aufrufbar ist. 

0.00 1 1 Port ist als Gamekontroller (CD32-Pad) definiert. 

001.0 2 Port ist als Maus definiert. 

001 1 3 Port ist als Joystick definiert. 

0 10 0 4 unbekanntes Eingabegerät 


Die Bits 17 bis 23 geben darüber Auskunf, was für ein Button am 
Eingabegerät gedrückt wurde: 


Bit_Name Funktion 

23 Button Blue blauer Knopf auf JoyPad bzw. rechte Maustaste 

22 Button Red roter Knopf auf JoyPad bzw. linke Maustaste bzw. Joystick-Fire 
21 Button Yellow gelber Knopf auf JoyPad (Repeat-Funktion) 

20 Button Green grüner Knopf auf JoyPad (Shuffle-Funktion) 

19 Button Forward rechte graue Taste für Vorwärts Spulen am JoyPad 

18 Button _Reverse linke graue Taste für Rückwärts Spulen am JoyPad 

17 Button _Play graue Mitteltaste am JoyPad für Play/Pause-Funktion bzw. 


mittlere Maustaste 


Die Bits O bis 15 sind abhängig vom Eingabegerät. Ist dieses als 
Maus definiert, so befindet sich im Hi-Byte (Bits 8 bis 15) die relative 
Y-Position der Maus und im Lo-Byte (Bits O bis 7) die relative X- 
Position (siehe Kapitel 17). Handelt es sich beim Eingabegerät um 
einen Joystick bzw. ein JoyPad, geben die Bits O bis 3 die gedrückte 
Richtung wieder. 


Rıichtungsbits (0 bis 3) für loysuck_bzw._loyPad) 


Bit_Name Funktion 

3 Joy_UP Joystick wurde nach oben bewegt 
2 Joy _DOWN Joystick wurde nach unten bewegt 
1 Joy_LEFT Joystick wurde nach links bewegt 

0 Joy_Right Joystick wurde nach rechts bewegt 
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so viel Theorie, jetzt ein Assembler-Listing das die Abfrage des 


Port! demonstriert. 


’ 


‘ — 
’ 


move.| 4,36 


jsr -132(a6) ; Forbid () 

move.| 4,36 

lea LowLevelName,al 

moveq #40,d0 

jsr -552(a6) ; OpenLibrary () 
move.l dO,LowLevelBase 

beq.b Exit 


- GamePort 1 als GameController (CD32 Pad) --- 


moveq #1,d0 ; Port 1 

lea Port1Taglist,al 

move.l LowLlevelBase,a6 

jsr -132(a6) ; SetJoyPortAttrsÄ () 


roten Knopf abfragen --- 


Loop: 
bsr.b ReadjoyPort ; GamePort 1 auslesen 
move.w Buttons,dO 
btst #6,d0 ; LeftMaus/JoyFire (22-16=6) 
bne.b Exit ; wenn gedrückt, dann Ende 
bra.b Loop 

Exit: 


move.l LowLevelBase,dO 
beq Exit_1 

move.| dO,al 

move.| 4,36 


isr -414(a6) ; CloseLibrary () 
Ext T: 

move.|l 4,36 

jsr -138(a6) ; Permit () 

rts 
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;--- GamePort 1 auslesen --- 


ReadjoyPort: 
moveg #1,d0 ; Port I 
move.l LowLevelBase,a6 
jsr -30(a6) ; ReadjoyPort 
move.w dO,Richtung 
swap do 


move.w dO,Buttons 
rts 


‘ 


LowLevelName: 
dc.b "Iowlevel.library",O 
even 


LowLevelBase: 


dc.| 0 
Port1TagList: 
dc.| $80c00101,1 ; SJA_ Type = GameController 
dc. 0 ; TAG DONE 
Richtung: 
dc.w 0 ; Bits O bis 3 
Buttons: 
dc.w 0 ; Bits 17 bis 23, Bits 28 bis 31 = Typ 


Routine: Gefey 

Library: Iowlevel.library 

Offset: -48 

Parameter: keine 

Rückgabe: DO = (Key) => Status der Tastaturabfrage und evtl. des 

Eingabegerätes. 

Erklärung: Diese Funktion ermittelt den aktuellen Wert der zuletzt 
gedrückten Taste und sofern über "SystemControlA ()" 
eingestellt, auch den des Eingabegerätes (Port). Im Low- 
Word steht dann der Wert der Taste bzw. des Eingabe- 
gerätes oder $FF und im Hi-Word die Qualifier (Sonder- 
taste) dazu oder Null. Diese Funktion kann auch in eine 


Seite 524 


Die LowLevel-Library Kapitel 14 


Interrupt-Routine eingebaut werden. 





Bit_N Funkti 
0(16) LLK_LSHIFT linke Shift-Taste gedrückt 
1(17) LLK_RSHIFT rechte Shift-Taste gedrückt 


2(18) LLK CAPSLOCK CapsLock-Taste gedrückt 
3(19) LLK_CONTROL Ctrl-Taste gedrückt 

4(20) LLK _LALT linke Alt-Taste gedrückt 
5(21) LLK_RALT rechte Alt-Taste gedrückt 
6(22) LLK LAMIGA linke Amiga-Taste gedrückt 


7(23) LLK_RAMIGA rechte Amiga-Taste gedrückt 


Die Werte für die Bits in Klammern beziehen sich auf das gesamte 
Longword der Rückgabe. 





jsr -48(a6) ; GetKey () 
swap dO 
btst #1,d0 ; rechte Shift-Taste gedrückt ? 


bne Right_Shift 


Right_ Shift: ; ab hier rechte ShiftTaste bearbeiten 
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Wenn über die Funktion "SystemControlA ()" mit "SCON Add- 
CreateKeys" die Werte der Ports auch in RawKey-Codes gewandelt 
werden, sind folgende Werte möglich: 


Wert _Name Funktion 

$72 PortO Button _Blue siehe ReadJoyPort () 
$73  PortO Button _Play siehe ReadJoyPort () 
$74 PortO_Button Reverse siehe ReadJoyPort () 
$75 PortO Button Forward siehe Read)JoyPort () 
$76 PortO Button Green siehe Read)JoyPort () 
$77 PortO Button Yellow siehe ReadJoyPort () 
$78 PortO Button Red siehe ReadjoyPort () 
$79 PortO_Button_Up siehe ReadjoyPort () 
$7A PortO Button Down siehe ReadjoyPort () 
$7B PortO Button _Right siehe ReadJoyPort () 
$7C PortO Button _Left siehe ReadJoyPort () 
$172 Porti_Button Blue siehe ReadJoyPort () 
$173 Porti_Button Play siehe ReadjoyPort () 
$174 Port _Button Reverse siehe ReadJoyPort () 
$175 Porti_Button Forward siehe ReadjoyPort () 
$176 Port! Button Green siehe ReadJoyPort () 
$177 Porti_Button_ Yellow siehe ReadjoyPort () 
$178 Port] Button Red siehe ReadJoyPort () 
$179 Porti_Button_Up siehe ReadJoyPort () 
$17A Porti_Button Down siehe ReadJoyPort () 
$17B Port! _Button Right siehe ReadjoyPort () 
$17C Port _Button Left siehe ReadjoyPort () 
$272 Port2_Button Blue siehe ReadjoyPort () 
$273 Port2_Button_Play siehe ReadjoyPort () 
$274 Port2_ Button Reverse siehe ReadJoyPort () 
$275 Port2_Button Forward siehe ReadjoyPort () 
$276 Port2 Button Green siehe ReadJoyPort () 
$277 Port2 Button Yellow siehe ReadjoyPort () 
$278 Port2_Button Red siehe ReadJoyPort () 
$279 Port2 Button Up siehe ReadjoyPort () 
$27A Port2 Button Down siehe ReadjoyPort () 
$27B Port2 Button Right siehe Read)oyPort () 
$27C Port2_Button Left siehe ReadjoyPort () 
$372 Port3_Button Blue siehe ReadJoyPort () 
$373 Port3_Button_Play siehe ReadJoyPort () 
$374 Port3_Button Reverse siehe ReadjoyPort () 
$375 Port3 Button Forward siehe Read)oyPort () 
$376 Port3 Button Green siehe ReadjoyPort () 
$377 Port3 Button Yellow siehe ReadJoyPort () 
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$378 Port3_Button_Red siehe ReadjoyPort () 
$379 Port3 Button _Up siehe ReadjoyPort () 
$37A Port3_Button Down siehe ReadjoyPort () 
$37B Port3_Button_ Right siehe ReadjoyPort () 
$37C Port3_Button Le siehe ReadjoyPort () 


Für die eigentlichen RawKey-Codes siehe Kapitel 17. 


Routine: 
Library: 
Offset: 
Parameter: 


Rückgabe: 
Erklärung: 


Querykeys (ArraySize,(QueryArray} (D1,A0) 
Iowlevel.library 

-54 

D1 = Größe des Tastenpuffers in Bytes 

AO = Adresse der Tastentabelle, die zu überprüfen sind. 
keine 


Mit dieser Funktion kann man mehrere Tasten gleich- 
zeitig abfragen. Dabei gibt man in AO die Anfangsadresse 
der Tabelle, welche die abzufragenden Tasten enthält und 
in DO die Länge der Tabelle in Bytes (für eine Taste = 4 
Bytes). Jede Taste besteht in der Tabelle aus zwei Words. 
Das erste Word muß den RawKey-Code der abzufragen- 
den Taste enthalten und das zweite Word enthält nach 
Aufruf der Funktion den Wert True (-1), wenn die Taste 
gedrückt wurde oder False (0), wenn nicht. 


Das folgende Assemblerlisting demonstriert das Abfragen von zwei 
Tasten gleichzeitig. 


move.l 
jsr 


move.| 
lea 
moveq 
jsr 
move.l 
beq.b 


4,a6 

-132(a6) ; Forbid () 

4,a6 

LowlLevelName,al ; LowLevelName 
#40,d0 


-552(a6) ; OpenLibrary () 
dO,LowLevelBase 


Exit 
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LOOPp: 

move.l LowLevelBase,a6 

lea QueryArray,a0 ‚ Array 

move.l #QueryArray_End-QueryArray,d ‚ Size 

jsr -54(26) ; QueryKeys () 

lea QueryArray,aO ; Array 

cmp.w #-1,2(a0) ; Taste A ? 

bne Loop ; nein, dann weiter abfragen 

cmp.w #-1,6(a0) ; Taste B ? 

bne Loop ; nein, dann weiter abfragen 
Exit: 

move.l LowLevelBase,dO 

beq Exit_1 


move.| dO,al 
move.| 4,36 


jsr -414(a6) ; CloseLibrary () 
Exit_1: 

move.l 4,36 

Isr -138(a6) ; Permit () 

rts 


LowLevelName: 
dc.b "Iowlevel.library",O 
even 


LowLevelBase: 


dc.l 0 

QueryArray: 
dc.w $20 ; kq KeyCodel = Taste A 
dc.w 0 ; kq_Pressed] 
dc.w $35 ; kq_KeyCode2 = Taste B 
dc.w 0 ; kq_Pressed2 


QueryArray_End: 
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In t-Funktionen 


Die LowLevel-Library bietet eine Menge Funktionen um leicht und 
schnell eigene Interrupts zu erzeugen, ohne die Hardware ansprechen 
zu müssen. 


Routine: AddkBint IntRoutine,IntData) (AO.A]) 

Library:  lowlevel.library 

Offset: -60 

Parameter: AD = Adresse des eigenen Interrupt-Tastatur-Programmes 

Al = Adresse des zum Programm gehörenden Daten- 

felds (Datenpuffer). 
Rückgabe: DO = (IntHandle) => Adresse des Interrupt-Handle, 
welche zu der Interrupt-Routine erzeugt wurde. 

Erklärung: Diese Funktion erzeugt einen eigenen Tastatur-Interrupt, 
der an die normale Systemtastaturabfrage gehängt wird. 
Sobald eine Taste gedrückt wurde, springt das System in 
Ihr Interruptprogramm. Ihrem Programm werden in Al 
das dazugehörige Datenfeld, in A5 die Adresse Ihres 
Interrupt-Programmes und in DO der RawKey-Code der 
gedrückten Taste übergeben. 

WICHTIG! Am Ende Ihres Interruptprogrammes muß in DO eine 
Null stehen. 


me nk a me a u a an m a m nn A FF u A nF A m A A FT A a TA 


Routine: AemkBint IntHandie) (Al) 

Library: lowlevel.library 

Offset: -66 

Parameter: Al = Adresse des Interrupt-Handle, die wir über die 
Funktion "AddKBint ()" erhalten haben. 

Rückgabe: keine 

Erklärung: Enfernt die eigene Tastatur-Interrupt-Routine wieder aus 
der System-Routine. 
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Routine:  AddVBlankınt fIntRoutine,IntData) (AOQAI) 

Library: Iowlevel.library 

Offset: -108 

Parameter: AD = Adresse der eigenen Interrupt-Routine, die an die 

VertikalBlank-System-Interrupt-Routine gehängt 
wird. 
Al = siehe AddKBint () 

Rückgabe: DO = (IntHandle) => siehe AddKBint () 

Erklärung: Diese Funktion erweitert die VertikalBlank-IRQ-Routine 
durch Ihr Programm. Ein VertikalBlank-Interrupt wird in 
der Austastlücke vor jedem Bildaufbau erzeugt. Bei der 
PAL-Version 50mal und bei der NTSC-Version 60mal in 
der Sekunde. Diese Routine ist oft für die Spieleprogram- 
mierung von Bedeutung (Double-Buffering, Musik etc.) 


Routine: RemVBlanklnt (IntHandle) (A1) 


Library: Iowlevel.library 

Offset: -114 

Parameter: Al = Adresse des Interrupt-Handle, welcher entfernt 
werden soll. 


Rückgabe: keine 
Erklärung: Entfernt Ihre VertikalBlank-Routine aus dem System. 


Routine:  AdafTımerint fIntRoutine,IntData) (AO.A]) 

Library: Iowlevel.library 

Offset: -78 

Parameter: AD = Adresse der eigenen Interrupt-Routine, die an die 

Timer-System-Interrupt-Liste gehängt wird. 

Al = siehe AddkBint () 

Rückgabe: DO = (IntHandle) => siehe AddKBint () 

Erklärung: Hängt Ihr Programm an einem der CIA-Timer-Interrupts 
an. Welcher CIA-Timer ausgewählt wird ist unbestimmt 
(CIAA oder CIAB). Diese Funktion ist wichtig, wenn Sie in 
bestimmten Zeitabständen etwas Abfragen oder Auslösen 
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möchten. Das Programm wird aber erst über die Funktion 
"StartTimerlnt ()" an den Timer gehängt und aufgerufen. 
Auch hier ist es wichtig, daß am Ende der Routine eine 
Null im DO steht. 


Routine:  Siart/imerint IntHandie, Timeinterval,Continuous) 
/41,00,D1) 
Library: lowlevel.library 
Offset: -90 
Parameter: Al = Interupt-Handle von Ihrem Timer-Programm 
DO = Zeitspanne, die angibt in welchen Abständen Ihr 
Timerprogramm aufgerufen werden soll in Micro- 
sekunden (maximal 90000). 
D1 = Dieses Flag legt fest, ob Ihr Timerprogramm nur 
einmal aufgerufen werden soll (True=-1) nach 
Ablauf der Zeitspanne oder fortlaufend im Abstand 
vom Timerlnterval (False=0). 
Rückgabe: keine 
Erklärung: Startet Ihr Timerprogramm in den angegeben Zeitab- 
ständen. Die Zeit kann jederzeit geändert werden, auch 
im eigenem Timerprogramm (Wichtig für eigene Play- 
Routine). Der Timer muß nicht erst mit der Funktion 
"StopTimerlnt ()" angehalten werden. 


Routine: Stop7imerint fIntkHlandie) (AT) 

Library: lowlevel.library 

Offset: -96 

Parameter: Al = Interrupt-Handle von Ihrem Timer-Programm 

Rückgabe: keine 

Erklärung: Unterbricht den fortlaufenden Modus im Timer-Interrupt. 
Nach Aufruf dieser Funktion wird das Timerprogramm 
evtl. noch abgearbeitet und danach nicht mehr aktiviert. 
Fortgesetzt kann der Timer nur wieder mit der Funktion 
"StartTimerlnt ()". 
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Routine: 
Library: 
Offset: 
Parameter: 
Rückgabe: 


Erklärung: 


Flapsec’Time (Context) (A0) 

Iowlevel.library 

-102 

AO = Adresse einer EClockVal-Struktur (8 Bytes) 

DO = (fractionalSeconds) = > Zeitspanne zum vorherigen 


Aufruf. 
Hi-Word = Anzahl Sekunden 
Lo-Word = Nachkommastelle der Sekunden 


Mit dieser Funktion läßt sich die Zeit zwischen zwei Auf- 
rufen messen. Beim ersten Aufruf gibt es noch keinen 
sinnvollen Rückgabewert. Erst ab dem zweiten Aufruf 
wird die verstrichende Zeit zum vorherigen Aufruf zurück- 
gegeben. Die EClockVal-Struktur beinhaltet einen Puffer 
von 8 Bytes, die vor dem ersten Aufruf auf Null gesetzt 
werden müssen. Diese Struktur wird für die Berechnung 
der verstrichenden Zeit benötigt. Diese Funktion greift 
auf das "timer.device" zu (Funktion "ReadEClock ()"). 


Aufbau der EClock Va/-Struktur: 


Offset_Typ_Name Funktion 


00° L 
04  L 


Routine: 
Library: 
Offset: 
Parameter: 
Rückgabe: 
Erklärung: 


EV HI 32-Hi-Bits der EClock im Amiga (Ticks/Sekunde) 
EV lo 32-Lo-Bits der ECLock im Amiga (Ticks/Sekunde) 


RemTimerlnt (IntHandle) (A1) 

Iowlevel.library 

-84 

Al = Interrupt-Handle von Ihrem Timerprogramm. 
keine 

Diese Funktion entfernt einen Timer-Interrupt aus dem 
System. 
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Hier noch ein Beispiellisting das die Timerprogrammierung demon- 


striert. 


move.l 
jsr 


move.l 
lea 
moveq 
jsr 
move.l 
beq.b 


;  bsr 


move.l 
lea 
sub.| 
jsr 
move.l 
beq.b 


move.l 
move.| 
move.l 
moveq 
jsr 


Loop: 
btst 
bne.b 


Exit: 
move.| 
beq 


,  bsr 
move.| 


move.| 
jsr 


4,36 
-132(a6) 


4,a6 
LowLevelName,al 
#40,d0 

-552(a6) 
dO,LowLevelBase 
Exit 


InitMusic 


LowLevelBase,a6 
TimelntRoutine,a0 
al,al 

-78(a6) 
dO,TimelntHandle 
Exit 


LowLevelBase,a6 
TimelntHandle,al 
#20000,d0 
#-1,d1 

-96(a6) 


#6,$bfe001 
Loop 


TimelntHandle,dO 
Exit_1 


; Forbid () 


; OpenLibrary () 


‚ evtl. Music init. 


;‚ AddTimerlnt () 


‚ Mikro-Sekunden = 1/50 Sekunde 
; TRUE (fortlaufend) 


; StartTimerlnt () 


; Linke Maustaste 


MusicOff ; ectl. Music ausschalten 


LowLevelBase,a6 
TimelntHandle,al 
-90(a6) 


; StopTimerlnt () 
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move.l LowLevelBase,a6 
move.|  TimelntHandle,al 


jsr -84(a6) ; RemTimerlnt () 
Exit_1: 

move.|l LowLevelBase,dO 

beq Exit 2 


move.l do,al 
move.| 4,36 


jsr -414(a6) ; CloseLibrary () 
Exit_2: 

move.|l 4,36 

jsr -138(a6) ; Permit () 

rts 


TimelntRoutine: 


movem.| dO-a6,-(a7) ; benutzte Register retten 

; bsr PlayMusic ; evtl. Musik abspielen 
movem.| (a7)+ ,dO-a6 ; alte Registerinhalte zurück 
moveq #0,d0 ; Routine mit Null verlassen 
rts 


TimelntHandle: 


dc.l 0 

LowLevelName: 
dc.b "Iowlevel.library",O 
even 


Low LevelBase: 
dc.| 0 
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14.2 Beispiel zur LowLevel-Library 


Zum Abschluß des Kapitels folgt ein Beispiellisting, das das System 
korrekt ausschaltet und evtl. eine eigene Copperliste aktiviert. Es 
können aber weiterhin Daten von der Festplatte geladen werden. Alle 
nötigen Interupts sollten Sie dann, wie oben beschrieben, aktivieren. 
Wenn Sie all diese Dinge beachten, läuft Ihr Programm (Spiel) 
100%ig auf jedem Amiga und es kommt nicht zu ungewollten 
Effekten, wie beim Start des Spiels erscheint ein kaputter Screen oder 
dergleichen. 


INCLUDE "Include/libraries/lowlevel.i" 


move.|l 4,36 


jsr -132(a6) ; Forbid () 

move.l| 4,36 

lea LowlevelName,al ; LowLevel-Library 
moveq #40,d0 

Isr -552(a6) ; OpenLibrary () 
move.l dO,LowlevelBase 

beq.b Exit 

move.|l LowLlevelBase,a6 

lea TagList1,al 

Isr -72(a6) ; SystemControlA () 
move.|l dO,System 

bne Exit 


. alte Copperliste ausschalten ohne das Screen zerhackt wird -- 
;--- Reihenfolge mit LoadView (0) und 2xWaitTOF () ist von . 
;-- Commodore vorgeschrieben . 


move.| 4,36 


lea GfxName,al ; Graphics-Library 
moveq #0,d0 

jsr -552(a6) ; OpenLibrary () 
move.l d0,GfxBase 

beq.b Exit 
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move.| dO,a6 


move.l 34(26),OldView ; Active View retten 
sub.l al,al 

jsr -222(a6) ; LoadView () 

jsr -270(a6) ; 2 x WaitTOF () 

jsr -270(a6) ;  WaitTOF () 


‘ 


;--- hier eigene Copperliste, Interrupts etc. starten - 
;-- es kann weiterhin auf die Festplatte/Disk zugegriffen werden --- 


lea CopperList,a2 
 move.l a2,$dff080 


Loop: 


btst #6, $bfe00 1 ; Linke Maustaste 
bne.b Loop 
Exit: 
move.l OldView,dO 
beq Exit_1 
move.l GfxBase,a6 
jsr -270(a6) ; WaitTOF () 
jsr -270(a6) ; WaitTOF () 
move.| OldView,al 
jsr -222(a6) ; LoadView () 
move.| 38(a6),$dff080 ‚ alte Copperliste starten 
EXIE 1: 
move.l GfxBase,dO 
beq Exit_2 


move.|l dO,al 
move.|l 4,36 


jsr -414(a6) ; CloseLibrary () 
Exit_2: 

tst.| System 

bne Exit_3 

move.l| LowLevelBase,a6 

lea TagList2,a] 

jsr -72(a6) ‚ SystemControlA () 
Exit 3: 

move.l LowLevelBase,dO 

beq Exit_4 


move.l dO,al 
move.l 4,36 
jsr -414(a6) ; CloseLibrary () 
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Exit_4: 


move.| 4,36 
jsr -138(a6) ; Permit () 
rts 


’ 


LowLevelName: 
dc.b "lowlevel.library",O 
even 


LowLevelBase: 


dc. 0 
System: 
dc. -1 ; Wichtig das -1 
GfxName dc.b "graphics.library",O 
even 
GfxBase: 
dc.| 
OldView: 
dc.l 0 
Taglist!: 
dc.| SCON_TakeOverSys,-1 ; TRUE 
dc. SCON_AddCreatekeys, I ; Port1-Signale in RawKeys 
de.l TAG_DONE 
Taglist2: 
dc.l SCON TakeOverSys,O ; FALSE 
de. SCON_RemCreateKeys, 1 ; Reset Port! 
de.l TAG_DONE 
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15. Animation 


Das Interressanteste beim Amiga, bei Computer allgemein, ist die 
Animation. Eine Animation ist nichts anderes als der Bewegungs- 
ablauf eines oder mehrerer Objekte. Ohne Animation geht heutzu- 
tage bei den Rechnern fast überhaupt nichts mehr, speziell bei 
Spielen. 


Deswegen ist das Programmieren von Animationen auch so ziemlich 
das Schwierigste und Zeitraubenste bei einem Spiel, Demo etc.. Das 
Problem dabei ist immer das ständige Ausprobieren, sobald nur eine 
kleine Änderung, zum Beispiel am Spiel, vorgenommen wurde. 


Am besten wäre es, wenn man diese Änderungen schnell und direkt 
auf dem Bildschirm, am besten noch mit der Maus, vornehmen 
könnte. Hat man dann seine komplette Animation am Bildschirm 
erstellt, wird sie als ein File auf Diskette gespeichert und kann diese 
ganz einfach ins eigene Programm einbinden. Das alles natürlich in 
maximaler Geschwindigkeit. 


Dafür wurde der Game-Animator entwickelt. Eine ausführliche Be- 
schreibung der Assemblerroutinen und eine Anleitung zum Pro- 
gramm befinden sich auf der Diskette. Der Animator wurde über 
viele Jahre immer weiter entwickelt und bietet in seiner jetzigen 
Version alles nötige um professionelle und systemfreundliche 
(LowLevel-Library) Spiele zu entwickeln. Es werden alle Amiga- 
Modelle ab 052.0 unterstützt. 
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16. Ein- und Ausgabegeräte 


Jetzt kennen wir die Hardware des Amigas und wissen wie wir sie 


programmieren, doch wie teilen wir es dem Rechner mit? 


Dafür existieren mehrere Möglichkeiten. Die Tastatur, um schnell 
große Informationsmengen zu übermitteln (z. B. Programmieren), der 
Joystick bei Spielen oder die Maus für graphische Benutzerober- 


flächen (Workbench). 


Wie wir die einzelnen Eingabegeräte programmieren, besprechen wir 


in den nächsten Abschnitten. 


16.1 Tastaturabfrage 


Bild 16.a 


Aa 


NINNENSINENANM 
BE I TE BAT ATI ATS 
Mg a al al al ala aM 
ME LIE EEE 
"IE 


alt 
Fuer 










Bild Ib.a 
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Die Tastatur besitzt einen eigenen Prozessor, welcher die Tastencodes 
erzeugt und sie bitweise an unsere CPU im Rechner schickt. Dafür 
stehen sieben Bits zur Verfügung. Das 8. Bit zeigt an, ob die Taste 
gerade gedrückt oder losgelassen wurde. Ist es auf Null, so ist die 
Taste gedrückt, andernfalls losgelassen. Wie man am Bild 16.a 
erkennen kann, handelt es sich bei den erzeugten Codes nicht um die 
fertigen ASCIl-Werte, sondern um sogenannte RAW-Codes. Diese 
besitzen aber trozdem ein bestimmtes System. 


$500-$3£f Raw-Codes der Buchstaben, Ziffern und 
Sonderzeichen 

$540-54f Raw-Codes der üblichen Sondertasten wie 
Enter, Space, Tab, Cursor etc. 

$50-$5£f Funktionstasten und Help 

$60-$67 Tasten zur Wahl der verschiedenen Tastatur- 
ebenen (Shift, Alternate etc.) 


Es gibt auch noch spezielle Raw-Codes, welche 8 Bit lang sind und 
folgende Funktionen haben: 


$78 Reset wird in ca. 10 Sekunden ausgelöst 
$F9 Letzter Code nicht in Ordnung 

$SFA Tastaturausgabepuffer voll 

$FB Unbenutzt 

SFC Tastatur Selbsttest 

$SFD Power-LED an 

SFE Power-LED aus 

$SFF Unbenutzt 


Wird ein Tastencode empfangen, sprich eine Taste gedrückt, so muß 
folgendes geschehen, bevor man den Code auswerten kann: 


1. Bit 3 im INTREQ-Register löschen 

2. Bit 3 im IRQ-Kontrollregister der CIA-A testen um zu sehen, ob 
die Tastatur den Interrupt ausgelöst hat. Bit 3 = 1, dann 
Tastatur-IRQ) 

3. Serielle Datenregister der CIA-A auslesen 


4. Seriellen Port von CIA-A auf Ausgabe stellen 
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in 


?. 
8. 


Tastatur antworten (Serielles Datenreg. mehrmals löschen) 
Empfangenden Code invertieren und um 1 nach rechts rotieren 
lassen 

Seriellen Port von CIA-A wieder auf Eingabe stellen 

Jetzt kann der RAW-Code weiter bearbeitet werden 


Als Assemblerlisting sieht dieses folgendermaßen aus: 


;—-- Port-Interrupt erlauben --- 


move.|l $68,old Ebene2 
move.l #ports,$68 
move.w #%7fff,$dff09a 
move.w #%c008, $dff09a 


;- hier folgt weiteres Programmm --- 


move.b rawkey,dO ; RawCode nach DO 
move.b ascii,d1 ; ASCII-Code nach D1 

;—- Port-IRQ) routine --- 

Ports: 
move.w #%8,$dff09c ; Port-IRQ zurücksetzen 
movem.| dO-d2/a0-al,-(sp) ; benutzte Register retten 
move.b $bfed01,d2 ; ICR-CIA-A auslesen 
btst #3,d2 ; Tastatur-IRQ ? 
beq end_ports ; wenn nicht, dann Ende 
move.b $bfec01,dO ; Serielles Datenregister auslesen 
ori.b #64, $bfeeO 1 ; Seriellen Port auf Ausgabe 
move.w #100,d1 ; Schleifenzähler 

ports_loop: ‚ Tastatur antworten 
cir.b $bfecO1 ; Serielles Datenreg. löschen 
dbra d1,ports loop ; 101 mal 
and.b #$bf,$bfee01 ; Serieller Port wieder Eingabe 
ror.b #1,d0 ; Code 1 nach rechts rotieren 
not.b dO ; und invertieren 

s— RAW-Code in DO auswerten --- 
cmp.b #$f9,dO ‚ letzter Tastencode fehlerhaft ? 
beq end _ ports 
cmp.b  #%fa,dO ; Tasturausgabepuffer voll ? 
beq end_ports 
cmp.b #$fc,dO ; Tastaturselbsttest ? 
beq end_ports 
cmp.b #%fd,do ; Power-LED an ? 
beq end_ports 
cmp.b #%fe,dO ; Power-LED aus ? 
beq end_ports 
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move.b dO,rawkey ; RAW-Code speichern 
;-—- RAW-Code in ASCII umwandeln --- 
cir.b ascıi 
cmp.b  #%e0,dO ; Shift up ? 
beq getascii_shift_up 
cmp.b #%e1,dO ; Shift up ? 
bne getascii_sd 
getascii_shift_up: 
cir.w shiftmode 
getascii_sd: 
cmp.b #%60,d0 ; Shift Down ? 
beq getascii_shift down 
cmp.b #%61,d0 ; Shift Down ? 
bne getascii go 


getascii_shift down: 
move.w #1,shiftmode 
getascii go: 
move.w dO,d1 
and.w #%7t,d1 
cmp.w #%40,d1 


bhi end_ports 

lea asciitable,a0 

tst.w shiftmode 

beq get_go 

lea asciishifttable,a0 
get_go: 

move.b (a0,d1.w),ascii 
end ports: 

movem.| (sp)+ ‚dO-d2/a0-a] 

rte 
asclitable: ; $00 - $40 


dc.b "" 123456 7890ß" ,0,"\*,0,"Oqwertzuiopü + ",0 
dc.b "123asdfghjklöä#",0,"456 < yxcvbnm, .-",0,0,"789",32 
even 
asciishifttable: ; $00 - $40 ö 
dc.b ""1",34,"8$%&/() = ?",0," |",0,"OQWERTZUIOPÜ*",O 
dc.b "123ASDFGHJKLOA” ",0,"456 > YXCVBNM;: _",0,0,"789",32 


even 

ascii: dc.w O ; hier steht fertiger ASCII-Code 
shiftmode: dc.w O ; = 1, dann Shift, 0 = Nein 
rawkey: dc.w O ; hier steht RAW-Code 
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16.2 Mausabfrage 


Für die Mausabfrage stehen zwei Port-Register zur Auswahl, Port A 
und Port B. Der Aufbau ist folgender: 


JOYODAT $DFFOOA (Gameport 0) - nur lesen 
JOY1DAT $DFFOOC (Gameport 1) - nur lesen 


Bitbel von beiden Registern: 


Bit: 15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00 
Funktion: Y7 Y6 Y5 Ya Y3 Y2 Y1 Yo X7 X6 X5 X4 X3 X2 X1 X0 


YO bis Y7 = Zähler für die vertikalen Mausbewegungen 
X0 bis X7 = Zähler für die horizontalen Mausbewegungen 


Die jeweils 8 Bit ergeben einen maximalen Zählerstand von 255. 
Bewegt man die Maus weiter, so entsteht ein Überlauf (von 255 auf 
0 oder von O auf 255). Deswegen muß man die Register in 
bestimmten Zeitabständen abfragen, damit eine korrekte Richtungs- 
auswertung erfolgen kann. Am besten erledigt man dieses während 
der vertikalen Austastlücke. 


Wie wird jetzt die Richtung und Anzahl Punkte einer Mausbewegung 
bestimmt? 


Man geht davon aus, das zwischen zwei Abfragen die Maus nicht 
mehr als 127 Pixel bewegt wurde. Dazu bildet man die Differenz 
zwischen dem alten und neuem Zählerstand. Ist das Ergebnis größer 
127, liegt ein Überlauf vor und die Maus wurde nach rechts bzw. 
unten bewegt. Ist das Ergebnis kleiner -127, liegt ein Unterlauf vor, 
was einer Mausbewegung nach links bzw. oben entspricht. 
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Liegt ein Unterlauf vor, errechnen sich die Anzahl Bewegungspunkte 
wie folgt: 


-255 - Differenz = Anzahl Pixel 


Liegt ein Überlauf vor, errechnen sich die Anzahl Bewegungspunkte 
wie folgt: 


255 - Differenz = Anzahl Pixel 


Die Gameport-Register lassen sich auch mit einem bestimmten Wert 
laden. Dafür gibt es das JOYTEST- Register. 


JOYTEST $DFFO36 (nur schreiben) 


Bits 15: 14 13. 12 11 10 09 08 07 06 05 04 03 902 01 00 
Funktion: Y7 Y6 Y5 YA Y3 Y2 xx xx X7 X6 X5 X4 X3 X2 xk< xx 


Da die Programmierung der Mausabfrage für viele sehr kompliziert 
ist, folgt ein kleines Assemblerlisting. 


move.w $dff00Oa,porta ; Porta einmal init. 


Ve 


bsr GetMaus ; Maus abfragen 
move.w mouse,dO ; Y-Pos. von Maus 
move.w mouse+2,d1 ; X-Pos. von Maus 


;--- Maus in Port A Abfragen über Interrupt --- 
i--- OLD Y,X in Mouse, NEW Y,X in Mouse — 


GetMaus: 
moveq #0,d0 
movegq #0,d1 
moveq #0,d2 
moveq #0,d3 
lea porta,a5 
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move.b (a5),dO ;:DO = Old Y | 
move.b 1(a5),d2 ;D2 = OldX | 
move.w $dff0Oa,(a5) ; New Y,X (Port A) | 
move.b (a5),d1 ; DI = New Y 
move.b 1(a5),d3 ;D3 = NEWX 
sub.w d3,d2 ; OldX - NewX 
and.w #%ff,d2 
neg.b d2 ; D2 = X-Offset 
ext.w d2 
add.w d2,mouse +2 ; New X-Pos. 

m_y: 
sub.w d1,dO ; OldY - NewY 
and.w #%ff,dO 
neg.b do ; DO = Y-Offset 
ext.w dO 
add.w _dO,mouse ; New Y-Pos. 

;-— Zusätzlich Screenbegrenzungen abfragen --- 

Mausgrenze: 
move.w mouse,dO ; DO = YPOS 
move.w mouse+2,d1 ; DI = XPOS 
cmp.w #320,d1 ; Max. X-Pos. 
bit mi 
move.w #320,mouse +2 
bra my 

m!: 
cmp.w  #0,d1 ; Min. X-Pos. 
bgt my 
move.w #0,mouse +2 

my: 
cmp.w #255,d0 ; Max. Y-Pos. 
bit m2 
move.w #255,mouse 
bra mend 

m2: 
cmp.w #0,d0 ; Min. Y-Pos. 
bgt mend 
move.w #0,mouse 

mend: 
rts 

porta: dc.w O ‚ enthält alten Zählerstand 

mouse: dc.| O ; absolute Mausposition Y, X 
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16.2.1 Joystickabfrage 


Der Joystick wird über die selben Register wie die Maus abgefragt. 
Da der Joystick jedoch acht Richtungen einnehmen kann, muß man 
bei der Programmierung ein wenig anders vorgehen. 


Bevor ein Port-Register ausgelesen wird, löscht man das JOYTEST- 
Register. Jetzt kann der korrekte Wert ausgelesen und verarbeitet 
werden. 


Beispiel: 
cir.w $dtf036 ; Joytest löschen 
move.w $dff00a,dO ‚ Porta auslesen 


Die Richtungswerte sind für beide Ports gleich. Welcher Wert für 
welche Richtung steht, können Sie der folgenden Tabelle entnehmen. 


Wert: Richtung: Wert: Richtung: 
S0100 oben 50103 oben/rechts 
50001 unten $0002 unten/rechts 
50003 rechts $S0200 oben/links 
50300 links 50301 unten/links 


Als letztes folgt noch die Abfrage der Feuer- und Maustasten, welche 
teilweise identisch sind. 


rechte Maustaste (Port A}: 


loop: 

btst #10,$dff016 

bne loop 
linke Maustaste und Feuerbutton (Port A}: 
loop: 

btst #6,$bfe001 

bne loop 
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rechte ort B)}: 
loop: 
btst #14,$dff016 
bne loop 
linke Maustaste und Feuerbutton (Port B): 
loop 


best #7 ‚$bfe001 
bne loop 
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1/7. Tonerzeugung 


Der Amiga ist ja bekanntlich prädestiniert für die Tonausgabe. Denn 
er verwendet nicht fest definierte Wellenformen (Sägezahn, Dreieck, 
Sinus etc.), wie zum Beispiel der Commodore 64, sondern fast frei 
programmierbare in 8 Bit Qualität. Dieses hat zur Folge, daß wir 
jedes Geräusch ungefähr in der selben Qualität über den Rechner 
abspielen können. 


Das Einlesen der Wellenformen geschieht über sogenannte Digi- 
talisierer, welche die analogen Daten in digitale umwandeln und im 
Rechner ablegen. Leider kann der Amiga nur Daten in 8 Bit 
verwalten und nicht wie bei der CD in 16 Bit. Für das menschliche 
Ohr ist der Unterschied jedoch nicht so gravierend. 


Die Daten werden als Wörter, die jeweils aus zwei Bytes bestehen, 
hintereinander abgelegt. Um solche digitale Daten, sprich den 
Sample, abspielen zu können, muß dem Rechner die Anfangsadresse 
und die Anzahl Bytes, die der Sample lang ist, mitgeteilt werden. Der 
Amiga verwendet auch hier wieder DMA-Kanäle, vier an der Zahl. 
Damit ist das unabhängige Abspielen von vier Samples gleichzeitig 
möglich. 


Anfangsadressen der Sampledaten: 
Adresse_Typ DMA-Kanal Funktion 


$DFFOAO LO Anfangsadresse der Sampledaten Kanal O 
$DFFOBO L 1 Anfangsadresse der Sampledaten Kanal 1 
$DFFOCO L 2 Anfangsadresse der Sampledaten Kanal 2 
$DFFODO L 3 Anfangsadresse der Sampledaten Kanal 3 
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Lä der Sampl n: 


Ad Typ_D | Funktion 

$DFFOA4 W O0 Länge der Sampledaten in Bytes Kanal O 
$DFFOB4 W 1 Länge der Sampledaten in Bytes Kanal 1 
$DFFOC4 W 2 Länge der Sampledaten in Bytes Kanal 2 
$DFFOD4 W 3 Länge der Sampledaten in Bytes Kanal 3 


Wird ein Sample gestartet, muß beachtet werden, daß dieser immer 
wieder abgespielt wird. Möchte man ein Sample nur einmal ab- 
spielen, so muß kurze Zeit nach dem Starten die Sampleadresse und - 
länge auf Null gesetzt werden. Dabei geht der aktuelle Registerwert 
nicht verloren, weil er intern bearbeitet wird. 


Damit wir den Sample auch hören, besitzt der Amiga vier Register, in 
denen wir für jeden Kanal getrennt, die Lautstärke zwischen Null und 
63 einstellen können. 


rke der Sampledaten is 63): 


r Typ_DMA- | Funktion 
$DFFVOAB W O0 Lautstärke der Sampledaten Kanal O 
$DFFOBB W 1 Lautstärke der Sampledaten Kanal 1 
$DFFOCB W 2 Lautstärke der Sampledaten Kanal 2 
$DFFOD8 W 3 Lautstärke der Sampledaten Kanal 3 


Das Lesen der Sampledaten geschieht wordweise in einer bestimmten 
Geschwindigkeit. Ändert man diese Geschwindigkeit, ergäbe das eine 
andere Ton- bzw. Samplehöhe. Das ganze wird als Tonfrequenz 
(Sample Rate) bezeichnet. Auch dafür existieren wieder vier Register. 
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Tonhöhe (Frequenz) der Sampledaten: 


Adresse Typ DMA-Kanal Funktion 


$DFFOA6 W O0 Tonhöhe der Sampledaten Kanal O 
$DFFOB6 W 1 Tonhöhe der Sampledaten Kanal 1 
$DFFOC6 W 2 Tonhöhe der Sampledaten Kanal 2 
$DFFOD6 W 3 Tonhöhe der Sampledaten Kanal 3 


Die Tonhöhe wird in der Regel von jedem Sampleprogramm 
angezeigt, ansonsten probieren Sie einfach ein paar Werte aus. 


Der Amiga bietet einem noch die Möglichkeit bestimmte Klangeffekte 
durch Modulation von Lautstärke und Frequenz zu erzeugen. Dabei 
arbeitet immer ein DMA-Kanal als Modulator, der die entsprechen- 
den Daten des nachfolgenden Kanals verändert. 


Der Modulationsoszillator liest wie gewohnt seine Samplewords aus 
dem Speicher. Schickt sie jetzt aber nicht an den Analog/Digital- 
Wandler, sondern schreibt sie in das Lautstärke- bzw. Frequenzre- 
gister des Kanals, den er modulieren soll. Es können auch Lautstärke 
und Frequenz gleichzeitig moduliert werden. Das ganze geschieht 
dann abwechselnd. 


Wird ein Kanal als Modulator eingesetzt, so wird sein Audioausgang 
automatisch abgeschaltet. Die Datenworte enthalten dann statt der 
Sampledaten abwechselnd die neue Lautstärke und Frequenz, wenn 
beides moduliert werden soll, ansonsten nur die Lautstärke bzw. die 
Frequenz. 


Das ADKCON-Register (siehe Kapitel 2) enthält die Bits, mit denen 
man die gewünschten Kanäle als Modulator einschalten kann. 
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ADKCON $DFFOYE (schreiben) / $DFFO1 n 
Bi N i 
15 SET/CLR Bits werden gesetzt (=1) oder gelöscht (=0) 
14 bis 8 Steuerbits für den Diskkontroller 
7 USE3PN Kanal 3 moduliert nichts 
6 USE2P3 Kanal 2 moduliert Frequenz von Kanal 3 
5 USEI1P2 Kanal 1 moduliert Frequenz von Kanal 2 
4 USEOP1 Kanal 0 moduliert Frequenz von Kanal 1 
3 USE3VN Kanal 3 moduliert nichts 
2 USE2V3 Kanal 2 moduliert Lautstärke von Kanal 3 
4 USE1V2 Kanal 1 moduliert Lautstärke von Kanal 2 
0 USEOV1 Kanal 0 moduliert Lautstärke von Kanal 1 


Als letztes müssen wir noch den jeweiligen Kanal einschalten, den wir 
benutzen möchten. Dafür enthält das DMACON-Register (Kapitel 1) 
vier Bits, für jeden Kanal eins. 


Registeradressen: schreiben => DMACON = $DFFO96 
lesen => DMACONR = $DFF002 
Bit _N i 


15 SET/CLR Bits löschen oder setzen 

14 BBUSY Blitter-DMA gerade in Funktion (nur lesen) 
13 BZERO Ergebnis der Blitteroperationen war 0 (nur lesen) 
12 ------ unbenutzt 

11 ------ unbenutzt 

10 BLTPRI Blitter-DMA hat Priorität über Prozessor 
9 DMAEN Gesamt-DMA einschalten (Bits 0 bis 8) 

8 BPLEN Bitplane-DMA zulassen 

7 COPEN Copper-DMA zulassen 

6 BLTEN Blitter-DMA zulassen 

5 SPREN Sprite-DMA zulassen 

4 DSKEN Disk-DMA zulassen 

3 AUD3EN Audio-DMA für Tonkanal 3 zulassen 

2 AUD2EN Audio-DMA für Tonkanal 2 zulassen 

1 AUDIEN Audio-DMA für Tonkanal 1 zulassen 

0 AUDOEN Audio-DMA für Tonkanal 0 zulassen 
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Beispiele: 
move.w #$8201,$dff096 ‚Kanal O ein 
move.w #$8202,$dff096 ‚ Kanal 1 ein 
move.w #$8204,$dff096 ‚Kanal 2 ein 
mvoe.w #%8208,$dff096 ‚ Kanal 3 ein 


move.w #$8203,$dff096 Kanal O und 1 ein 


17.1 Audio-Interrupt 


Wenn wir wie oben beschrieben einen Sample aktivieren, wird dieser 
in einer Endlosschleife abgespielt. Um das zu verhindern können wir 
zwei Tricks anwenden. Entweder wir schalten den Sample sofort 
wieder ab (siehe nächsten Abschnitt) oder wir benutzen einen Audio- 
Interrupt. 


Sobald der Kanal das Ende der Audiodaten erreicht hat, wird ein 
Interrupt ausgelöst. Wir können jetzt das INTREQR-Register abfragen, 
wann der Sample am Ende ist oder wir initialisieren einen Audio- 
Handler wie in Kapitel 13.9 beschrieben. 


17.2 einen Sample abspielen 


Zum Abschluß dieses Kapitels stelle ich Ihnen eine Routine vor, mit 
der Sie über Kanal 2 einen Sample einmal abspielen können. Am 
besten Sie digitalisieren einen Sample vorher und speichern ihn im 
RAW-Format ab. Dieses Sampleformat können Sie jetzt in Ihr 
Programm einbinden oder nachladen und mit der unten stehenden 
Routine abspielen. Möchten Sie den Sample über einen anderen 
Kanal abspielen, so brauchen Sie nur die entsprechenden Adressen im 
Listing ändern. 
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Die WaitTime-Funktion ist nötig, damit der Sample auch auf Turbo- | 
Amigas korekt abgespielt wird. | 


;--- Sample über Kanal 2 abspielen -_.. 
;--- AO = Sampleadresse ... 
;--- DO = Samplelänge in Bytes -—— 
;--- DI = Samplehöhe --- 
PlaySample: 


lea $dff000,a2 ; Chipbasis 
move.w #4,$96(a2) ;‚ Kanal 2 
move.w di,d2 
moveq #10,d1 ; Time verändern, wenn Sample 
bsr.w waittime ; nicht richtig ertönt 
cir.w (a0) ‚ erstes Datenword löschen 
move.| &0,$c0(a2) ‚ Sampleadresse Kanal 2 
move.w dO,$c4(a2) ; Samplelänge Kanal 2 
move.w da2,$c6(a2) ; Samplehöhe Kanal 2 
move.w #64,$c8(a2) ; volle Lautstärke 
move.w #%8004,$96(a2) ; Kanal wieder aus 
moveg #10,d1 ; damit nur einmal gespielt 
bsr.w waittime ; wird 
move.|l a0,$c0(a2) ; Sampleadresse Kanal 2 
move.w #1,$c4(a2) ; Länge 1 Word für Kanal aus 
rts 
;i-—- Zeitschleife —— 
;--- Di = loop (1 ca. 64 microsec.) _.. 
WaitTime: 


move.l d2,-(sp) 
waittime_next: 

move.b $dff006,d2 
waittime_ loop: 

cmp.b $dff006,d2 

beq.b waittime_loop 

sub.| #1,d1 

bne.b  waittime_next 

move.l (sp)+,d2 

rts 
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18. Die Libraries 


Hier war eigentlich eine kurze Beschreibung der wichtigsten Libraries 
im Amiga vorgesehen. Aufgrund des Umfanges, würde es den 
Rahmen des Buches sprengen. Dafür sind aber am Ende des Buches 
alle Funktionen der wichtigsten Bibliotheken im Kurzformat 
beschrieben. Für den geübten Programmierer, sind diese Listen eine 
enorme Arbeitserleichterung. 


Bereits in den vorangegangen Kapiteln haben wir den Aufbau der 
Libraries und noch einiges mehr beschrieben. Für das Öffnen einer 
Bibliothek ist immer eine Versionsnummer erforderlich. Einige 
Funktionen setzen auch eine bestimmte Mindestversionsnummer 
voraus. Würden wir hier eine Null übergeben, für egal, bedeutet daß 
den Absturz (Guru...) des Rechners. 


Versionsnummern der Amiga-Libraries 


Version Kickstart-ROM 
00 Versionsnummer ist egal 
30 Kickstart V1.0 (nicht benutzen) 
31 Kickstart V1.1 (NTSC - nicht benutzen) 
32 Kickstart V1.1 (PAL - nicht benutzen) 


33 Kickstart V1.2 (älteste brauchbare Version) 
34 Kickstart V1.3 (Autoboot-Funktionen) 
35 spezielle Version zur Unterstützung für A2024-Monitor 


36 Kickstart V2.0 (älteste OS2-Version) 
37 Kickstart V2.04 (echte OS2.0-Version) 
38 Kickstart V2.1 (0OS2.1-Version) 

39 Kickstart V3.0 (OS3.0-Version) 

40 Kickstart V3.1 (0S3.1-Version) 
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19. IFF-Standard 


Jeder der heutzutage einen Amiga sein eigen nennt, besitzt in der 
Regel auch ein oder mehrere Malprogramme, zumal diese gegen 
einen geringen Aufpreis schon mitgeliefert werden. Mit diesen 
Programmen ist es ein leichtes ein Bild zu entwerfen. Doch wie 
können wir dieses Bild im eigenem Programm aktivieren? 


Dazu hat das Softwarehaus Electronic Arts das "Interchange-File- 
Format" entwickelt. Zu jedem Bild werden noch zusätzliche Infor- 
mationen, welche in einem festgelegten Format vorliegen, mitabge- 
speichert. Aufgrund dieses festgelegten Formats, kann man ein Bild 
auch mit anderen Malprogrammen laden. 


Diesen IFF-Standard gibt es auch für Text, Musik, Animation usw.. 
Wir wollen hier aber nur auf den Grafik-Standard eingehen. 


Wir bereits erwähnt, wird zum eigentlichen Bild noch ein Header 
mitabgespeichert. Dieser steht am Anfang des Bildes und ist in 
Bereiche aufgeteilt, welche die Bezeichnung Chunk tragen. Jeder 
Chunk (Block/Bereich) beginnt mit einem Namen, danach folgt die 
Länge des Chunks in Bytes und dann die eigentlichen Informationen. 
Durch dieses Prinzip läßt sich der IFF-Standard jederzeit erweitern. 


19.1 Bilder 


Ein IFF-Bild ist in Blöcke (Chunks) aufgeteilt. Die wichtigsten, die zum 
Aktivieren eines Bildes ausreichen, werden wir jetzt besprechen. 
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1. FORM-Chunk-Struktur (Länge = 12 Bytes) 


Offset_Typ_Inhalt 

00 L "FORM" => vier große ASCII-Buchstaben 
04 L Länge des ganzes Files 

08 L "ILBM* => vier große ASCII-Buchstaben 


Achtung! - Die Filelänge wird nicht immer korekt von DPaint 
abgespeichert. 


2. BMHD-Chunk-Struktur (Länge = 28 Bytes) 


Typ. Inhalt 


00 L "BMHD" => vier große ASCII-Buchstaben 
04 L Länge des BMHD-Blocks (20 Bytes) 
08 W Breite der Grafik 
10 W Höhe der Grafik 
12 W  X-Position der Grafik (meistens 0) 
14 W  Y-Position der Grafik (meistens O) 
16 B Anzahl der Bitplanes (Tiefe) 
17 B Art des Masking: 

0 = Kein Masking 

1 = Masking 

2 = Transparent 

3 = Lasso 
18 B  _Datenkompression-Mode 

0 = Bild ist nicht gepacked 

1 = Bild ist gepacked 
19 B unbenutzt 
20 W  Transparentfarbe für Masking = 2 
22 B  X-Aspekt (unwichtig) 
23 B Y-Aspekt (unwichtig) 
24 W Breite der Quellseite (Screen) 
26 W Höhe der Quellseite (Screen) 


3. CMAP-Chunk-Struktur (2 hoch Tiefe * 3 + 8) 


Offset Typ_ Inhalt 
00 


L "CMAP" => vier große ASCII-Buchstaben 
04 L Länge des CMAP-Blocks (2 hoch Tiefe * 3 = Bytes) 
08 B Rotanteil von Farbe O 
09 B Grünanteil von Farbe O 
10 B Blauanteil von Farbe O 
USW. 2... für alle anderen Farbregister bis maximal 256 (AA) 
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4. BODY-Chunk-S r (lLä = ab ig vom Bil 


Typ_Inha 
00 L "BODY" => vier große ASCII-Buchstaben 
04 L Länge des BODY-Blocks (der Bilddaten) 
08 B Datenbytes 


.... hier folgen die eigentlichen Datenbytes 


Da fast jedes Bild gepacked wird, folgt die Beschreibung des 
Packvorgangs. 


Erst müsen wir festellen, ob das Bild überhaupt gepacked ist, was uns 
das Kompressionsbyte im BMHD-Chunk verrät. Ist dies der Fall, so 
können wir das Bild jetzt entpacken. Dabei ist zu beachten, daß ein 
Bild nicht bitplaneweise gepacked ist, sondern zeilenweise. Das heißt, 
es kommt zuerst die erste Zeile von Bitplane 1, dann die erste Zeile 
von Bitplane 2 und so weiter bis zur Letzten. Dann folgt evtl. die 
erste Zeile der Maskenplane, wenn Masking ungleich null ist. Jetzt 
folgt die zweite Zeile von Bitplane 1, dann die zweite Zeile von 
Bitplane 2 usw.. 


Zum eigentlichen Packvor . 


Es darf immer nur zeilenweise entpacked werden, niemals mehrere 
auf einmal. 


Die gepackten Daten sind! folgendermaßen aufgebaut: 


Erst kommt das Befehlsbyte für den Entpacker, das wir als "n" 
bezeichnen. Ist "n" eine Zahl zwischen O und 127, so werden die 
nächsten (n+1) Bytes unverändert übernommen. Ist "n" jedoch 
negativ (> 128), also eine Zahl zwischen -1 und -127, so wird das 
folgende Byte (-n+1) mal wiederholt. Der Wert 128 hat keine 
Funktion und kann übersprungen werden. Das war schon alles. 
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Es folgt noch eine kleine Routine, mit der man IFF-Bilder, auch 
256farbige, mit Hilfe der bisher beschriebenen Routinen, darstellen 
kann. 


Routine: PrintIFFPic (AO-A2) (Bitmap/IFFAdresse./ColorPuffer) 
Parameter: AO = Adresse der Bitmap-Struktur, in der das Bild entpacked werden 
soll. Größe und Breite müssen übereinstimmen. 
Al = Adresse des IFF-Bildes 
A2 = Anfangsadresse von einem Puffer, in dem die Farben abgelegt 
werden sollen (im 24-Bit-Format) 
Eine Farbe besitzt eine Länge von vier Bytes, siehe Kapitel 20) 
Rückgabe: => DO = -1, dann Error aufgetreten 
=> DO = Anzahl Farben, dann OK 
Erklärung: 
Diese Funktion printet ein IFF-Bild in eine Bitmap und erzeugt die notwendigen 
Farben. Nur für das Zeilenbitmapformat anwendbar (siehe Animator, d. h. für normale 
Bitmaps (Aufbau: bitmapweise), müssen Sie das Listing entsprechend ändern. 


Hier noch das dazugehörige Assemblerlisting: 


;--- (AO-A2) (BitMap,IFF-Adr.,Colorpuffer) = 
;--- => DO = Anzahl Colors, dann OK; -1 = Error --- 
PrintlffPic: 

movem.| a0-a2,-(sp) 

move.|l al,pic_buf 
;-—- Iff-Chunk-Adressen suchen --- 


iff_search: 
lea chunktabelle,al 
lea chunkadresse,a2 
iffsearchO: 
move.l #1000,d0 ; ersten 1000 Bytes durchsuchen 
move.| pic _buf,a0 
cmp.!l #0,(a1) ; schon alle Chunks gefunden ? 
beg.b _ iffsearch end 
move.l (al)+,d7 ; Chunkkennzeichnung holen (z.B BODY) 
iffsearch_search: 
move.l (a0),d6 ‚ ersten LONG aus Picpuffer holen 
cmp.| d7,d6 ; Chunk gefunden ? 
beq.b _ iffsearch found 
addq.w #2,20 


dbra dO,iffsearch search 
movem.| a0-a2,-(sp) 

moveq #-1,d0 ; Error 
rts 
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iffsearch_found: 


move.| (a2)+,a4 ; Chunkpufferadresse holen 
move.l a0,(a4) ; und Chunkadresse eintragen 
bra.b iffsearchO 
iffsearch_end: 
moveq #0,d0 
move.| bmhd_chunk,a0 
move.b 16(a0),dO 
subq.w #1,d0 
move.w dO,planes num 
movem.| (sp)+ ,a0-a2 
u Iff Farben errechnen (24 Bit) und speichern -- 
move.| cmap_chunk,a4 
addq.w #4,a4 
moveq #0,d7 
move.| (a4)+,d7 
divu #3,d7 
move.w d7,cmap_count 
subaq.w #1,d7 
move.| a2,al 
co loop: 
moveq #0,d0 
move.b (a4)+,dO 
move.b dO,d1 
Isr.b #4,d1 
Isl.b #4,d0 
or.b d1,dO 
swap dO 
move.b (a4)+,dO 
move.b dO,d1 
Isr,b #4,d1 
Isl.b #4,d0 
or.b d1,dO 
Isi.w #8,d0 
move.b (a4)+,dO 
move.b dO,d1 
Isr.b #4,d1 
Isl.b #4,d0 
or.b d1,dO 
move.|l dO,(al)+ 
dbra d7,co_loop1 
;-—- Parameter fuer entpacker --- 
move.| 8(a0),a2 ; 1. Bitmapptr. 
move|l bmhd_chunk,a0O ; BMHD-Chunk-Adresse 
moveg #0,d3 
move.b 17(a0),d3 ; MaskenByte setzen 
move.b 18(a0),compression ; PackerByte 
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moveq 
move.b 
subq.w 
moveq 
move.w 
Isr.w 
move.l 
addq.w 
move.| 
lea 
bsr.b 
moveq 
move.w 
rts 


rd 


#3,d0 
body_chunk,a0 
#4 ,a0 

(a0)+,d1 
(a0,d1.1),a3 
unpacker 
#0,d0 
cmap_count,dO 


Ei Iff-Unpacker-Routine --- 


unpacker: 
cmp.l 
bhs.b 
move.w 
move.| 

pic_loop!: 
bsr.b 
dbra 
move.l 
and.b 
beq.b 
lea 
bsr.b 
bra.b 


unpack_row: 


move.l 
movel 
unp loop]: 
tst.w 
beq.b 
tst.b 
bne.b 
subq.w 
bra.b 
unp comp: 
moveq 
move.b 
cmp.b 
beq.b 
tst.b 
bmi.b 


a3,a0 
unpack end 
d2,d4 
a2,a5 


unpack_row 
d4,pic_loop 1 
a5,a2 

#1,d3 

unpacker 
mask_dummy,a5 
unpack_row 
unpacker 


dO,d7 
d7,d5 


d’ 

unpack end 
compression 
unp comp 
#1,d5 
unp_loop2 


#0,d5 
(a0) +,d5 
#128,d5 
unp comp 
d5 

packed 


; Depth 


; Zeilenbytebreite 
; BODY-Chunk-Adresse 


; Bodylaenge 

; A3 = Bildende 
; entpacken 

; OK 


Bild schon entpacked ? 
; wenn ja, dann Ende 


or 


und Daten entpacken 
wenn nicht, dann weiter 


ne. >. 


sonst Maske entpacken 
wenn vorhanden ? 
Maskenpuffer 
entpacken 

wieder von vorne 


a Wet a: 


‚ Zeilenbreite in Bytes 


schon eine Zeile durch ? 

; Wenn ja, dann naechste 
Pic gepacked ? 

; wenn ja, dann Unp Comp 
minus 1 

; und Bytes uebernehmen 


-- 


-.- 


Befehlsbyte holen 


oo. 


; Wenn negativ, dann gepacked 
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unp_loop2: 
move.b 
subg.w 
dbra 
bra.b 

packed: 
neg.b 
move.b 

unp loop3: 
move.b 
subq.w 
dbra 
bra.b 

unpack_ end: 
rts 


(a0) + ,(a5)+ ‚ sonst Bytes normal uebernehmen 


#1,d7 ; Zeilenbreite minus 1 
d5,unp_loop2 ; Schleife bis Anzahl Null 
unp_loop] ; Von vorne 

d5 ; Befehlsbyte negieren 
(a0) +,d6 ; Fuellbyte nach d6 
d6,(a5)+ ; Zeile mit 

#1,d7 ; Fuellbyte beschreiben 
d5,unp_loop3 ; Schleife 

unp loop! ; vor vorne 


;--- Parameter fuer Entpacker -- 


maske: 
compression: 
chunktabelle: 


chunkadresse: 


iffchunk: 


bmhd_chunk: 


cmap_chunk: 
body_chunk: 


cmap_count: 
planes num: 
pic_buf: 
chunk_size: 
bif: 


dc.l 0 

dc.| O0 

dc.| "BMHD*,"CMAP*","BODY",O 

dc.| bmhd_chunk,cmap_chunk,body_chunk 
dc.l O0 


dc.l 0 
dc.| 0 
dc.! 0 


dc.w O 
dc.w O 
dc.1 0 
dc.| O 
dc.! O0 


mask_dummy: bik.b 512,0 
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20. AA-Hardware 


Zum Abschluß des Buches, folgt jetzt noch eine kurze Beschreibung 
des AA-Chipsets, das sich im Amiga 1200 und 4000 befindet. Ich 
weise aber ausdrücklich darauf hin, daß alle Informationen teilweise 
auf Insiderinformationen und zum größten Teil auf Versuche 
basieren. Deswegen muß es sich nicht um die originalen Register- 
namen bzw. Bitbezeichnungen handeln. Auch wird für evtl. auftre- 
tende Schäden oder Fehler keine Haftung übernommen. Denn 
Commodore hat bisher noch keine offiziellen Informationen über das 
AA-Chipset herausgegeben, da diese nicht mehr kompatibel zu den 
neuen AAA-Chipset sein sollen, die in der nächsten Amiga- 
Generation eingesetzt werden. So war der damalige Stand zu 
Commodore Zeiten. Inwieweit Amiga-Technologies die Hardware 
weiterentwickelt und ob dieses ChipSet die Bezeichnung AAA tragen 
wird, bleibt abzuwarten. 


Veränderungen bei dem AA-Chipset: 


Bis zu den ECS-Amigas standen nur maximal 32 verschiedene Farben, 
aus einer Farbpalette von 4096 zur Verfügung. Die Ausnahme waren 
der HAM-Modus (alle 4096 Farben gleichzeitig) und der ExtraHalf- 
Brite-Modus (64 Farben). Beim AA-Chipset können 256 verschiedene 
Farben in jedem Modus (außer Dualplayfield) und im HAM-Modus 
sogar 262.144 Farben gleichzeitig benutzt werden. Alles aus einer 
Farbpalette von 16.777.216 Farben. Die Pixelausgabe kann entweder 
verdoppelt oder vervierfacht werden (Bandbreite). Die Bitmapadresse 
muß dann durch 4 bzw. 8 teilbar sein. Das Betriebs-system verwendet 
jetzt zwei Arten von Bitmapaufbau. Den bitmap- und den 
zeilenweisen Aufbau der Playfields (Interleaved), welchen wir auch 
beim Animator verwenden, weil er einfach schneller ist. Bei 
Interleaved-Bitmaps müssen die Modulowerte auch entsprechend 
berechnet werden (Anzahl Tiefe-1 Bitplanezeilenlänge in Bytes zusätz- 
lich überspringen). Das Scrolling der Playfields läßt sich jetzt zwischen 
1/4 bis 64 Pixel einstellen. 
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Die Spritebreite kann zwischen 16, 32 und 64 Pixel betragen, die 
Auflösung ist variabel von LoRes bis SuperHighRes (140 ns bis 35 ns) 
und die Spritepalette kann fast frei eingestellt werden. 


Di n Regi ; 
$SDFFOFB BPL7PTH Anfangsadresse von Bitmap 7 (Hi-Word) 
$DFFOFA BPL7PTL Anfangsadresse von Bitmap 7 (Lo-Word) 
$SDFFOFC BPL8PTH Anfangsadresse von Bitmap 8 (Hi-Word) 
$DFFOFE BPL8PTL Anfangsadresse von Bitmap 8 (Lo-Word) 
SDFFI1C BPL7DAT Bitplane 7 Daten zum RGB-Ausgang 
SDFFI11E BPL8DAT Bitplane 8 Daten zum RGB-Ausgang 
BPLCO DFF100): 
Bit Name Funktion wenn Bit = 1 
15 HIRES hochauflösender Modus ein (Screenbreite 640) 
14 BPU2 Diese drei Bits legen 
13 BPUl die Anzahl Bitmaps und damit 
12 DBPUO die Anzahl Farben fest (0 bis 6) 
11 HAM Hold &Modify Modus ein (4096 Farben gleichzeitig) 
10 DPF Dualplayfield Modus ein (zwei unabhängige Screens) 
9 COLOR Videoausgang auf Farbe (für Amiga 1000) 
8 GAUD Genlock Audio einschalten 
7 UHRES 
6 SHRES Superhires Modus ein (Screenbreite 1280) [ab ECS] 
5 BYPASS unbekannte Funktion [ab ECS] 
4 BPU3 hier wird 8 Bitplane eingeschaltet 
3 LPEN LightPen-Eingang aktivieren 
2 LACE Interlace-Modus aktivieren (doppelte Screenhöhe) 
1 ERSY Bildschirmausgabe extern synchronisieren (Genlocks) 
0 ENBPLCN3 aktivieren des Registers BPLCON3 [ab ECS] 
Erk : 


Mit dem BPU3-Bit kann die zusätzliche 8. Bitplane eingeschaltet 
werden, welche ja für 256 Farben erforderlich ist. BPU2 bis BPUO 
müssen dann aber Null sein. Außerdem muß für die Benutzung des 
AA-Chipset das Bit O (ENBPLCN3) gesetzt sein, damit die zusätzlichen 
Register aktiviert werden. 
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Folgende Farbanzahl steht jetzt zur Verfügung: 


BPU3 BPU2 BPU1 BPUO _ Anzahl Bitplanes Anzahl Farben 


0 1) 0 0 0 0 Farben 

0 0 0 I 2 2 Farben 

0 ) 1 0 2 4 Farben 

0 0 A 1 3 8 Farben 

0 " 0 0 4 16 Farben 
0 1 0 1 5 32 Farben 
0 1 1 0 6 64 Farben 
0 1 1 ı 7 128 Farben 
1 ) 0 0 8 256 Farben 


Beim Dualplayfield-Modus kann jetzt jedes Playfield aus maximal vier 
Bitplanes bestehen, daraus resultiert eine Farbanzahl von jeweils 
maximal 16. 


Für den HAM8-Modus (262.144 Farben) müssen alle acht Bitplanes 
eingeschaltet und das KILLHB-Bit (Nr. 9) im BPLCON2-Register auf 
eins sein. Die Farberzeugung läuft genau wie im HAM6-Modus ab, 
nur das jetzt die Planes 1 bis 6 die 64 Echtfarben erzeugen und die 
Planes 7 und 8 die Farbanteile modifizieren. 


Der HAM8-Modus: 


Bedingung: BPUx = 8, KILLHB = 1, ENBPLCN3 =1 


Farben: Planes 1 bis 6 erzeugen die 64 Echtfarben 
Planes 7 und 8 modifizieren den Farbanteil 

Plane7 P F un 

0 0 Farbe aus den Planes 1 bis 6 

0 1 Blauanteil ändern 

1 0 Rotanteil ändern 

1 1 Grünanteil ändern 

BPLCON1 ($DFF102): 

Bit Name Funktion wenn Bit = 1 
15 P2H7 + 32 Pixel scrollen => gerade Planes 
14 P2H6 + 16 Pixel scrollen => gerade Planes 
13 P2H1 + 1/2 Pixel scrollen => gerade Planes 
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12 P2HO + 1/4 Pixel scrollen => gerade Planes 
11 P1H7 + 32 Pixel scrollen => ungerade Planes 
10 PI1H6 + 16 Pixel scrollen => ungerade Planes 
9 PIıHI + 1/2 Pixel scrollen => ungerade Planes 
8 PIHO + 1/4 Pixel scrollen => ungerade Planes 
7 P2H5 + 8 Pixel scrollen => gerade Planes 

6 P2H4 + 4 Pixel scrollen => gerade Planes 

5 P2H3 + 2 Pixel scrollen => gerade Planes 

4 P2H2 + 1 Pixel scrollen => gerade Planes 

3 PI1H5 + 8 Pixel scrollen => ungerade Planes 
2 P1H4 + 4 Pixel scrollen => ungerade Planes 
1 PI1H3 + 2 Pixel scrollen => ungerade Planes 
0 PIH2 + 1 Pixel scrollen => ungerade Planes 
Erklärung: 


Die Bits O bis 7 sind für das pixelweise Scrolling gleichgeblieben. Mit 
den restlichen Bits läßt sich jetzt ein feineres oder gröberes Scrolling 
erreichen. 


BPL 2 ($DFF104): 


Bi i Bit = 1 
15 xxx unbekannt 
14 ZDBPSEL2 Funktion dieser [ab ECS] 
13 ZDBPSELI1 drei Bits [ab ECS] 
12 ZDBPSELO unbekannt [ab ECS] 
11 ZDBPEN benutze Bitplane-Key [ab ECS] 
10 ZDCTEN benutze Color-Key [ab ECS] 
9 KILLEHB Halfbrite Modus unterdrücken, bei 6 Planes [ab ECS] 
8 xxx unbekannt => Bits 8 und 7 auf Null setzen, sonst 
TV RER unbekannt => erscheint kein Signal am TV-Modulator 
6 PF2PRI gerade Planes vor ungeraden (nur bei Dualplayfield) 
5 PF2P2 Priorität der 
4 PF2P1 Sprites in Bezug 
3 PF2PO auf die geraden Planes 
2 PFIP2 Priorität der 
ı PFIPI Sprites in Bezug 
0 PFIPO auf die ungeraden Planes 
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Erklärung: 


Wird der AA-Modus benutzt, so muß man das KILLHB-Bit auf eins 
setzen, weil sonst bei 6 Bitplanes und kein HAM6-Modus der 
ExtraHalfBrite-Modus aktiviert wird. 


BPLCON3 ($DFF106): 


Bit Name Funktion wenn Bit = 1 
55 COLORP2 Drei-Bitzahl als Zeiger auf die aktuelle 
14 COLORP1 Farbpalette, welche gerade 
13 COLORPO bearbeitet werden soll 
12 PF2OF2 für Dualplayfieldmodus: Farbtabellenoffset für 
11 PF2OF1 Playfield 2 (gerade). Folgende mögliche Offsets: 
10 PF2OFO 0/2/a/8/16/32/64/128 = 8 Variationen bei 3 Bits 
9 ColorHi wählt die oberen 12 Bits einer Farbe an (12 - 23) 
8 xxx unbekannt (auf Null setzen) 
7 SPRRES1I Spriteauflösung: 
6 SPRRESO Normal/Lores/Hires/SuperHires 
5 BRDRBLNK Bildschirmrand ausschalten (schwarz) 
4 BRDNTRAN Bildschirmrand transparent 
3 XXX unbekannt (auf Null setzen) 
2 xxx unbekannt (auf Null setzen) 
1 BRDSPRT Sprite kann jetzt über Rand bewegt werden 
0 xxx unbekannt (auf Null setzen) 
Erklärung: 


Da der Amiga nicht 256 verschiedene Farbregister hat, sondern 
immer noch die alten 32 Color-Register, verwendet man beim AA- 
Chipset 8 verschiedene Farbpaletten, welche immer auf die 32 Color- 
Register von $DFF180 bis $DFFIBE zugreifen. Welche Farbpalette 
nun gerade bearbeitet werden soll, bestimmen die Bits 15 bis 13 im 
BPLCON 3- Register. 


Bit15 Bit14 Bit13 Farbpalette 


0 0 ) Palette 0 (Farbregister 000 bis 031) 
0 0 1 Palette 1 (Farbregister 032 bis 063) 
0 1 0 Palette 2 (Farbregister 064 bis 095) 
0 1 1 Palette 3 (Farbregister 096 bis 127) 
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Palette 4 (Farbregister 128 bis 159) 
Palette 5 (Farbregister 160 bis 191) 
Palette 6 (Farbregister 192 bis 223) 
Palette 7 (Farbregister 224 bis 255) 


Frr#r 
Hroo 
HKoro 


Die alten Farbregister besaßen nur eine Farbbreite von 12 Bit (= 
4096 Farben). Bei dem AA-Chipset wurde diese auf 24-Bit verdoppelt 
(= 16.777.216 Farben). Und weil die Color-Register nur WORD- 
Register sind und damit keine 24 Bit aufnehmen können, wird jedes 
Colorregister zweimal benutzt. Zuerst werden die 12-High-Bits (Bits 
23 bis 12) aufgenommen und dann die 12-Low-Bits (Bits 11 bis O). 
Dieses wird durch das Bit 9 im BPLCON3- Register festgelegt. Ist es 
auf Null, so werden nur die Bits 23 bis 12 der Farbregister bearbeitet 
(Normal-Amiga), andernfalls die Bits 11 bis O (ergibt feinere 
Farbabstufungen). 


ColorHi COLORxx -Aufbau 


Bit9; ı» 34 13 32 2. 2 9 7 4 03 _ 02 01 00 
0 xX XX XX XX R7 R6 R5 RA G7 G6 G5 G4 B7 B6 B5 B4 
1 XxXX XX XX Xx R3 R2 R1 RO G3 G2 G1 GO B3 B2 Bil BO 


R7 bis RO = Rotanteil der Farbe 
G7 bis GO = Grünanteil der Farbe 
B7 bis BO = Blauanteil der Farbe 


Ei liste könn m Beispiel u N: 


Copperlist: 
dc.w $0106,$0000 ; Palette O, 12-High-Bits 
dc.w $0180,$0xxx ; ColorO0, Bits 23 bis 12 
dc.w $0182,$0xxx ; ColorO1, Bits 23 bis 12 


 de.w $O1BE,$Oxxx ; Color31, Bits 23 bis 12 
dc.w $0106,$0200 ; Palette 0, 12-Low-Bits 
dc.w $0180,$0xxx ; Color00, Bits 11 bis O 
dc.w $0182,$0xxx ; ColorO1, Bits 11 bis O 
dc.w $O1BE,$0Oxxx ; Color31, Bits 11 bis O 


en ab hier werden Farbregister 32 bis 63 bearbeitet --- 
dc.w $0106,$1000 ; Palette 1, 12-High-Bits 
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dc.w $0180,$0xxx ; Color32, Bits 23 bis 12 
dc.w $0182,$0xxx ; Color33, Bits 23 bis 12 


dc.w $O1BE,$0Oxxx ; Color63, Bits 23 bis 12 
dc.w $0106,$1200 ; Palette 1, 12-Low-Bits 
dc.w $0180,$0xxx ; Color32, Bits 11 bis O 
dc.w $0182,$0xxx ; Color33, Bits 11 bis O 
 de.w $O1BE,$Oxxx ; Color63, Bits 11 bis O 


Er USE er 
dc.w $FFFF,$FFFE ; End of Copperlist 


Mit den Bits 7 und 6 läßt sich die Auflösung der Sprites einstellen. 
Diese ist unabhängig von der verwendeten Screenauflösung. Dadurch 
erscheinen die Sprites feiner, aber auch kleiner in der Breite (1/2 
oder 1/4 Breite). 


Bit7 Bit6 Spriteauflösung 


0 0 Normal (Lo-Res bis ECS-Amiga) => 140 ns 
0 1 LoRes (AA-Chipset) => 140 ns 
1 0 HiRes (AA-ChipSet) => 70 n8 
1 1 SuperHires (AA-ChipSet) => 35 ns 


BPLCON4 ($DFF10C): 


Bit Name Funktion wenn Bit = 1 

15-8 2??? Colormaske zum Anwählen einer Farbe für Copper (XOR) 
7-4 2??? Spritepalette für gerade Sprites (0/2/4/6) 

3-0 ??? Spritepalette für ungerade Sprites (1/3/5/7) 


Erklärung: 


Die Sprites können weiterhin aus maximal 16 Farben bestehen 
(Attached-Sprite). Bei 256 Farbregistern, macht das 16 verschiedene 
Farbpaletten (256/16 = 16). Welche Farbpalette für alle Sprites ge- 
nommen werden soll, bestimmen die Bits 7 bis 4, für die Sprites mit 
gerader Nummer und die Bits 3 bis O, für die Sprites mit ungerader 
Nummer. 
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Bit7 Bit6 Bit5 Bit4 
Bit3 Bit2 Biti1 BitO Farbpalette 


0 0 0 0 Spritepalette 0 (Farbregister 000 bis 015) 
0 0 0 1 Spritepalette 1 (Farbregister 016 bis 031) 
0 0 1 0 Spritepalette 2 (Farbregister 032 bis 047) 
0 0 1 3 Spritepalette 3 (Farbregister 048 bis 063) 
0 1 0 0 Spritepalette 4 (Farbregister 064 bis 079) 
0 1 0 1 Spritepalette 5 (Farbregister 080 bis 095) 
0 1 1 0 Spritepalette 6 (Farbregister 096 bis 111) 
0 1 1 1 Spritepalette 7 (Farbregister 112 bis 127) 
1 0 0 0 Spritepalette 8 (Farbregister 128 bis 143) 
E 0 0 1 Spritepalette 9 (Farbregister 144 bis 159) 
1 0 1 0 Spritepalette (Farbregister 160 bis 175) 
1 0 1 2 Spritepalette (Farbregister 176 bis 191) 
1 1 0 0 Spritepalette (Farbregister 192 bis 207) 
1 1 0 1 Spritepalette (Farbregister 208 bis 223) 
1 1 1 0 Spritepalette (Farbregister 224 bis 239) 
1 1 1 1 Spritepalette 15 (Farbregister 240 bis 255) 
CLXCON2 ($DFFIOE): 

Bi N i Bit = 1 

15-8 --- unbenutzt 
7 ENBP8 Bitplane 8 mit MVBP8 vergleichen 
6 ENBP7 Bitplane 7 mit MVBP7 vergleichen 

5-2 . unbenutzt 
1 MVBP8 Wert für Kollision mit Bitplane 8 
0 MVBP7 Wert für Kollision mit Bitplane 7 

Erk : 


In diesem Register sind die fehlenden Bits, der 7. und 8. Bitmap, für 
die Collisionserkennung festgelegt (siehe Kapitel 10). 


F DFFIFC): 


Bit Name Funktion wenn Bit = 1 
15 SPRSCAN Sprite Scan-Doubling einschalten 


14 BSCAN Bitplane Scan-Doubling einschalten 

13-4 ---- unbenutzt 

3 ??? doppelte Spritepixelausgabe vom CHIP auf Screen 
2 ??? doppelte Spritebreite (32 Pixel) 


Seite 569 


AA-Hardwar itel 2 


I ??? doppelte Pixelausgabe vom Chip auf Screen 
0 72? doppelte Bitplanebreite (Bus = 32 Pixel) 
Erklärung: 


Mit diesem Register kann die Sprite- und Bildschirmausgabe be- 
schleunigt und die Sprite- und Bitplanebusbreite verdoppelt werden. 
Das Register ist auch die Ursache dafür, daß bei einigen Pro- 
grammen die Grafik zerstört ist, wenn sie gestartet werden. Wird 
dieses Register im eigenem Programm vorher auf Null gesetzt, so 
tritt dieser Effekt nicht auf. 


Das Sprite kann folgende Breiten einnehmen: 


Bit3 Bit2 Spritebreite 


0 0 16 Pixel (Sprite-Adresse muß durch 2 teilbar sein) 
0 1 32 Pixel (Sprite-Adresse muß durch 4 teilbar sein) 
1 0 32 Pixel durch beschleunigte Ausgabe 

L 3 64 Pixel (Sprite-Adresse muß durch 8 teilbar sein) 


Wird eine beschleunigte Ausgabe der Bilddaten eingestellt (Bits 1 
und O0), so müssen die Modulowerte etwas modifiziert werden (0, -4 
oder -8). Auch ist darauf zu achten, daß die Bitmapadresse durch 2 
(Bandbreite = 1), 4 (Bandbreite = 2) oder 8 (Bandbreite = 16) teilbar 
ist. Verwenden Sie deshalb zum Reservieren von Bitmap-Speicher die 
Grafik-Funktion "AllocBitmap ()". Die Adressen der Bitmaps sind dann 
immer durch 8 teilbar (64-Pixel). Für spätere OS-Versionen kann die 
Bandbreite noch größer sein. 


Die Spritekontrollwörter haben sich auch ein wenig geändert bzw. 
wurden erweitert: 


SPRXxPOS (1. Controllword): 


Bit N Funktion 
15-8 E7-EO Erste Zeile des Sprites (Startzeile Bits 0 bis 7) 
7-0 H10-H3 horizontale Position (Bits 3 bis 10) 
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B N i 
1 


5-8 L7-LO Letzte Zeile des Sprites (Endzeile Bits 0 bis 7) 

7 AT Attached-Bits (für 16-Farben-Sprites) 

6 E9 9, Bit der ersten Zeile 

5 L9 9. Bit der letzten Zeile 

4 Hl horizontale Position für 70 ns Sprites (HiRes) 

3 HO horizontale Position für 35 ns Sprites (SuperHiRes) 
2 E8 8. Bit der ersten Zeile 

1 L8 8. Bit der letzten Zeile 

0 H2 horizontale Position für 140 ns Sprites (LoRes) 


Wie die Spritekontrollwörter für Sprites mit einer Breite von 32 oder 
64 Pixel aussehen, müssen Sie am besten selbst in Erfahrung bringen. 
Normalerweise dürfte es nur zwei Möglichkeiten geben. Entweder ist 
es das erste oder letzte Word einer Spritehälfte. Die Routinen zum 
Animator enthalten schon Funktionen für AA-Sprites. Alle notwendi- 
gen Informationen können Sie der Beschreibung auf Disk entnehmen. 


So das waren bisher alle Informationen, die ich rauskriegen konnte 
und wohl auch die wichtigsten. Ich wünsche Ihnen viel Spaß beim 
Ausprobieren. 


Die im Animator verwendeten Routinen unterstützen schon das AA- 


Chipset. Sie müssen einfach für die Routine InitColor () bzw. 
InitCopperlList () die Variable "mode24bit" auf eins setzen. 
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Anhang A - Programme der Disketten 


Auf den beiliegenden Disketten befinden sich im "HWB-Verzeichnis" 
alle Beispiellistings unter der jeweiligen Kapitelbezeichnung. Zusätz- 
lich finden Sie die aktuelle Version des Game-Animators, mit dem das 
Erstellen von professionellen Spielen zum Kinderspiel wird. Eine 
Anleitung zum Programm und den Grafiksystem befindet sich eben- 
falls auf den Disketten. 


Anhang B - Library-Funktionen 


Wie bereits angekündigt, folgen jetzt die Listen der wichtigsten 
Bibliotheken. Jede Funktion beginnt mit ihrer Einsprungadresse 
(dezimal), danach folgt der Name und zum Schluß die Parameter mit 
den dazugehörigen Registern. Eine leere Klammer "()" bedeutet keine 
Parameter erforderlich. 


dos.library 


-30 Open (name,accessMode)(D1/D2) 

-36 Close (file)(D1) 

-42 Read (file,buffer ‚length)(D 1/D2/D3) 
-48 Write (file,buffer,length)(D 1/D2/D3) 
-54 Input ()() 

-60 Output ()() 

-66 Seek (file,position,offset)(D 1/D2/D3) 
-72 DeleteFile (name)(D1) 

-78 Rename (oldName,newName)(D 1/D2) 
-84 Lock (name,type)(D 1/D2) 

-90 Unlock (lock)(D1) 

-96 Duplock (lock)(D1) 

-102 Examine (lock fileinfoBlock)(D 1/D2) 
-108 ExNext (lock fileinfoBlock)(D 1/D2) 
-114 Info (lock,parameterBlock)(D 1/D2) 
-120 CreateDir (name)(D1) 

-126 CurrentDir (lock)(D1) 

-132 loErr 

-138 CreateProc (name,pri,segList,stackSize)(D 1/D2/D3/D4) 
-144 Exit (returnCode)(D1) 
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-150 LoadSeg (name)(D1) 

-156 UnLoadSeg (seglist)(D1) 

;-- zwei interne Systemfunktionen —- 
-162 GetPacket (wait) (D1) 

-168 QueuePacket (packet) (D1) 

;--- Anwenderfunktionen --- 

-174 DeviceProc (name)(D1) 

-180 SetComment (name,comment)(D1/D2) 
-186 SetProtection (name,protect)(D 1/D2) 
-192 DateStamp (date)(D1) 

-198 Delay (timeout)(D1) 

-204 WaitForChar (file,timeout)(D 1/D2) 
-210 ParentDir (lock)(D1) 

-216 Isinteractive (file)(D1) 

-222 Execute (string file,file2)(D1/D2/D3) 
;— Funktionen ab V36 -- 

;- DOS Object creation/deletion —- 

-228 AllocDosObject (type ,tags)(D1/D2) 

-234 FreeDosObject (type,ptr)(D1/D2) 

;-- Packet-Funktionen -- 

-240 DoPkt (port,action,arg 1,arg2 arg3,arg4,arg5)(D1/D2/D3/D4/D5/D6/D7) 
-246 SendPkt (dp,port,replyport)(D1/D2/D3) 

-252 WaitPkt ()() 

-258 ReplyPkt (dp,res1,res2)(D 1/D2/D3) 

-264 AbortPkt (port,pkt)(D1/D2) 

;-- Record-Locking-Funktionen -- 

-270 LockRecord (fh,offset,length,mode,timeout)(D 1/D2/D3/D4/D5) 

-276 LockRecords (recArray,timeout)(D1/D2) 

-282 UnlLockRecord (fh,offset,length)(D 1/D2/D3) 

-288 UnLockRecords (recArray)(D1) 

;-- gepufferte File Input/Output-Funktionen -—- 

-294 Selectinput (fh)(D1) 

-300 SelectOutput (fh)(D1) 

-306 FGetC (fh)(D1) 

-312 FPutC (fh,ch)(D1/D2) 

-318 UnGetC (fh,character)(D1/D2) 

-324 FRead (fh,block,blocklen,number)(D1/D2/D 3/D4) 

-330 FWrite (fh,block,blocklen,number)(D1/D2/D3/D4) 

-336 FGets (fh,buf,buflen)(D1/D2/D3) 

-342 FPuts (fh,str)(D 1/D2) 

-348 VF\WVritef (fh,format,argarray)(D1/D2/D3) 

-354 VFPrintf (fh,format,argarray)(D1/D2/D3) 

-360 Flush iD) 
-366 SetVBuf (fh,buff,type,size)(D1/D2/D3/D4) 
;- DOS Object Management-Funktionen -- 
-372 DupLockFromFH (fh)(D1) 
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-378 OpenfromlLock (lock)(D1) 

-384 ParentOfFH (fh)(D1) 

-390 ExamineFH (fh,fib)(D1/D2) 

-396 SetFileDate (name,date)(D 1/D2) 

-402 NameFromlLock (lock,buffer ‚len)(D 1/D2/D3) 

-408 NamefFromFH (fh,buffer ‚len)(D1/D2/D3) 

-414 SplitName (name, seperator ‚buf,oldpos,size)(D 1/D2/D3/D4/D5) 
-420 SameLock (lock 1,lock2)(D 1/D2) 

-426 SetMode (fh,mode)(D 1/D2) 

-432 ExAll (lock,buffer ‚size,data,control)(D1/D2/D3/D4/D5) 
-438 Readlink (port,lock,path,buffer ‚size)(D 1/D2/D3/D4/D5) 
-444 MakeLink (name ,‚dest,soft)(D1/D2/D3) 

-450 ChangeMode (type,fh,newmode)(D 1/D2/D3) 

-456 SetFileSize (fh,pos,mode)(D1/D2/D3) 

;--- Funktionen für Fehlerauswertung --- 

-462 SetloErr (result)(D1) 

-468 Fault (code,header,buffer ‚len)(D 1/D2/D3/D4) 

-474 PrintFault (code,header)(D 1/D2) 

-480 ErrorReport (code,type,arg1,device)(D 1/D2/D3/D4) 
;--- reserviert für Zukunft --- 

-486 DosReserveD1 ()() 

;--- Process Management Funktionen --- 

-492 Cli (0 

-498 CreateNewProc (tags)(D1) 

-504 RunCommand (seg, stack,paramptr,paramlen)(D 1/D2/D 3/D4) 
-510 GetConsoleTask ()() 

-516 SetConsoleTask (task)(D1) 

-522 GetFileSysTask ()() 

-528 SetFileSysTask (task)(D1) 

-534 GetArgStr ()() 

-540 SetArgStr (string)(D1) 

-546 FindCliProc (num)(D1) 

-552 MaxCli ()() 

-558 SetCurrentDirName (name)(D1) 

-564 GetCurrentDirName (buf,len)(D1/D2) 

-570 SetProgramName (name)(D]) 

-576 GetProgramName (buf,len)(D1/D2) 

-582 SetPrompt (name)(D1) 

-588 GetPrompt (buf,len)(D1/D2) 

-594 SetProgramDir (lock)(D1) 

-600 GetProgramDir ()() 

;-- Device-List-Management Funktionen -- 

-606 SystemTaglist (command,tags)(D 1/D2) 

-612 AssignLock (name,lock)(D1/D2) 

-618 AssignLate (name,path)(D1/D2) 

-624 AssignPath (name,path)(D1/D2) 

-630 AssignAdd (name,lock)(D 1/D2) 

-636 RemAssignList (name,lock)(D 1/D2) 
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-642 GetDeviceProc (name,dp)(D1/D2) 

-648 FreeDeviceProc (dp)(D1) 

-654 LockDostist (flags)(D1) 

-660 UnLockDostist (flags)(D1) 

-666 AttemptLockDostist (flags)(D1) 

-672 RemDosEntry (dlist)(D1) 

-678 AddDoseEntry (dlist)(D1) 

-684 FindDosEntry (dlist,name,flags)(D 1/D2/D3) 
-690 NextDosEntry (dlist,flags)(D 1/D2) 

-696 MakeDosEntry (name,type)(D 1/D2) 

-702 FreeDosEntry (dlist)(D1) 

-708 IsFileSystem (name)(D1) 

;- Handler-Interface Funktionen -- 

-714 Format (filesystem ‚volumename,dostype)(D 1/D2/D3) 
-720 Relabel (drive,newname)(D 1/D2) 

-726 Inhibit (name,onoff)(D1/D2) 

-732 AddBuffers (name,number)(D 1/D2) 

;-- Datum- und Zeitfunktionen —- 

-738 CompareDates (date1,date2)(D1/D2) 

-744 DateToStr (datetime)(D1) 

-750 StrToDate (datetime)(D1) 

;--- Image-Management Funktionen --- 

-756 InternalloadSeg (fh,table,funcarray,stack)(DO/AO/A 1/A2) 
-762 InternalUnLoadSeg (seglist,freefunc)(D1/A1) 
-768 NewloadsSeg (file,tags)(D1/D2) 

-774 AddSegment (name,seg,system)(D 1/D2/D3) 
-780 FindSegment (name,seg,system)(D 1/D2/D3) 
-786 RemSegment (seg)(D1) 

;-- Command-Support Funktionen --- 

-792 CheckSignal (mask)(D1) 

-798 ReadArgs (arg_template,array,args)(D1/D2/D3) 
-804 FindArg (keyword,arg_template)(D1/D2) 
-810 Readitem (name,maxchars,cSource)(D 1/D2/D3) 
-816 StrToLong (string,value)(D1/D2) 

-822 MatchFirst (pat,anchor)(D1/D2) 

-828 MatchNext (anchor)(D1) 

-834 MatchEnd (anchor)(D1) 

-840 ParsePattern (pat,buf,buflen)(D1/D2/D3) 
-846 MatchPattern (pat,str)(D1/D2) 

;- eine interne Systemfunktionen --- 

-852 dosPrivate3 ()() 

-858 FreeArgs (args)(D1) 

;- reserviert für Zukunft --- 

-864 DosReserveD2 ()() 

-870 FilePart (path)(D1) 

-876 PathPart (path)(D1) 

-882 AddPart (dirname, filename,size)(D 1/D2/D3) 
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;--- Notification-Funktionen --- 

-888 StartNotify (notify)(D 1) 

-894 EndNotify (notify)(D1) 

;- Environment Variable-Funktionen -- 

-900 SetVar (name,buffer ‚size, flags)(D 1/D2/D3/D4) 
-906 GetVar (name,buffer ‚size, flags)(D 1/D2/D3/D4) 
-912 DeleteVar (name, flags)(D1/D2) 

-918 FindVar (name,type)(D1/D2) 

;--- eine interne Systemfunktionen --- 

-924 dosPrivate4 ()() 

-930 ClilnitNewcli (dp)(AO) 

-936 ClilnitRun (dp)(AO) 

-942 WriteChars (buf,buflen)(D1/D2) 

-948 PutStr (str)(D1) 

-954 VPrintf (format,argarray)(D1/D2) 

;- reserviert für Zukunft --- 

-960 DosReserveD3 ()() 


u Funktionen ab V37 -- 


-966 ParsePatternNoCase (pat,buf,buflen)(D 1/D2/D3) 

-972 MatchPatternNoCase (pat,str)(D 1/D2) 

;- eine interne Systemfunktionen --- 

-978 dosPrivate5 ()() 

-984 SameDevice (lock 1,lock2)(D1/D2) 

-990 ExAllEnd (lock,buffer ‚size,data,control)(D 1/D2/D3/D4/D5) 
-996 SetOwner (name,owner_info)(D 1/D2) 


exec.library 


;-- misc-Funktion -- 

-30 Supervisor (userFunction)(A5) 

;-- 6 spezielle interne Exec-Funktionen --- 

-36 Exitintr ()() 

-42 Schedule ()() 

-48 Reschedule ()() 

-54 Switch ()() 

-60 Dispatch ()() 

-66 Exception (}() 

;--- Module-Funktionen -- 

-72 InitCode (startClass,version)(DO/D1) 

-78 InitStruct (initTable,memory,size)(A1/A2,DO) 

-84 MakeLibrary (funclnit,structlnit,libinit,dataSize,segList)(AO/A 1/A2,D0/D1) 
-90 MakeFunctions (target,functionArray,funcDispBase)(AO/A 1/A2) 
-96 FindResident (name)(A1) 

-102 InitResident (resident,segList)(A1,D1) 
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;--- Diagnose-Funktionen --- 

-108 Alert (alertNum)(D7) 

-114 Debug (flags)(DO) 

;--- Interrupt-Funktionen --- 

-120 Disable ()() 

-126 Enable ()() 

-132 Forbid ()() 

-138 Permit () 

-144 SetSR (newSR,mask)(D0/D1) 

-150 SuperState ()() 

-156 UserState (sysStack)(DO) 

-162 SetintVector (intNumber,interrupt)(DO/A1) 
-168 AddintServer (intNumber,interrupt)(DO/A1) 
-174 RemintServer (intNumber,interrupt)(DO/A1) 
-180 Cause (interrupt)(A1) 

;-- Funktionen für Speicherverwaltung --- 

-186 Allocate (freeList,byteSize)(A0,DO) 

-192 Deallocate (freeList,memoryBlock,‚byteSize)(A0/A 1,DO) 
-198 AllocMem (byteSize,requirements)(DO/D1) 
-204 AllocAbs (byteSize,location)(DO/A1) 

-210 FreeMem (memoryBlock,byteSize)(A 1,D0) 
-216 AvailMem (requirements)(D1) 

-222 AllocEntry (entry)(AO) 

-228 FreeEntry (entry)(AO) 

;— Funktionen zur Listenverwaltung --- 

-234 Insert (list,node,pred)(AO/A1/A2) 

-240 AddHead (list,node)(A0/A1) 

-246 AddTail (list,node)(A0/A1) 

-252 Remove (node)(A1) 

-258 RemHead (list)(AO) 

-264 RemTail (list)(AO) 

-270 Enqueue (list,node)(AO/A1) 

-276 FindName (list,name)(AO/A1) 

;--- Task-Funktionen --- 

-282 AddTask (task, initPC,finalPC)(A 1/A2/A3) 
-288 RemTask (task)(A1) 

-294 FindTask (name)(A1) 

-300 SetTaskPri (task,priority)(A1,DO) 

-306 SetSignal (newSignals,signal$et)(D0/D1) 
-312 SetExcept (newSignals,signalSet)(DO/D1) 
-318 Wait (signalSet)(DO) 

-324 Signal (task,signalSet)(A1,DO) 

-330 AllocSignal (signalNum)(DO) 

-336 FreeSignal (signalNum)(DO) 

-342 AllocTrap (trapNum)(DO) 

-348 FreeTrap (trapNum)(DO) 

;--- Message-Funktionen --- 

-354 AddPort (port)(A1) 
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-360 RemPort (port)(A1) 

-366 PutMsg (port,message)(AO/A1) 

-372 GetMsg (port)(AO) 

-378 ReplyMsg (message)(A1) 

-384 WaitPort (port)(AO) 

-390 FindPort (name)(A1) 

;--- Library-Funktionen --- 

-396 AddLibrary (library)(A1) 

-402 RemLibrary (library)(A1) 

-408 OldOpenLibrary (libName)(A1) 

-414 CloseLibrary (library)(A1) 

-420 SetFunction (library,funcOffset,newFunction)(A 1,A0,DO) 
-426 Sumlibrary (library)(A1) 

;-- Device-Funktionen --- 

-432 AddDevice (device)(A1) 

-438 RemDevice (device)(A1) 

-444 OpenDevice (devName ‚unit,ioRequest,flags)(A0,DO/A1,D1) 
-450 CloseDevice (ioRequest)(A1) 

-456 DoIO (ioRequest)(A1) 

-462 SendIO (ioRequest)(A1) 

-468 ChecklO (ioRequest)(A1) 

-474 WaitlO (ioRequest)(A1) 

-480 AbortlO (ioRequest)(A1) 

;--- Resource-Runktionen --- 

-486 AddResource (resource)(A1) 

-492 RemResource (resource)(A1l) 

-498 OpenResource (resName)(A1l) 

;--- 3 interne Diagnose-Funktionen --- 

-504 RawlOlnit ()() 

-510 RawMayGetChar ()() 

-516 RawPutChar (char)(DO) 

;--- misc-Funktionen --- 

-522 RawDofFmt (formatString,dataStream,putChProc,putChData)(AO/A1/A2/A3) 
-528 GetCC ()() 

-534 TypeOfMem (address)(A1) 

-540 Procure (sigsem,bidMsg)(A0/A1) 

-546 Vacate (sigsem,bidMsg)(AO/A1) 

-552 OpenLibrary (libName,version)(A1,DO) 


;--- Funktionen ab V33 (05 1.2) -- 


;--- Funktionen für Signal/Semaphores --- 
-558 InitSemaphore (sigsem)(A0) 

-564 Obtainsemaphore (sigsem)(AO) 
-570 Releasesemaphore (sigsem)(AO) 
-576 AttemptSemaphore (sigsem)(AO) 
-582 ObtainSemaphorelist (sigsem)(AO) 
-588 ReleaseSemaphorelist (sigSem)(AO) 
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-594 FindSemaphore (sigSem)(A1) 

-600 AddSemaphore (sigSem)(A1) 

-606 RemSemaphore (sigsem)(A1) 

;--- Kickstart-Memory Funktion --- 

-612 SumKickData ()() 

;--- weitere Speicherverwaltungs-Funktionen --- 

-618 AddMemtist (size ‚attributes,pri,base,name)(D0/D1/D2/AQ/A1) 
-624 CopyMem (source ,dest,size)(A0/A 1,DO) 

-630 CopyMemQuick (source,dest,size)(AO/A1,DO) 


;- Funktionen ab V36 (052.0) 


;- CPU-Cache-Funktionen --- 

-636 CacheClearu ()() 

-642 CacheClearE (address,length,caches)(A0,DO/D1) 
-648 CacheControl (cacheBits,cacheMask)(DO/D 1) 
;- Misc-Funktionen -- 

-654 CreatelORequest (port,size)(A0,DO) 

-660 DeletelORequest (iorequest)(A0) 

-666 CreateMsgPort ()Ü) 

-672 DeleteMsgPort (port)(AO) 

-678 ObtainSemaphoreShared (sigSem)(AO) 

;-- weitere Speicherverwaltungs-Funktionen --- 
-684 AllocVec (byteSize,requirements)(DO/D 1) 
-690 FreeVec (memoryBlock)(A1) 


Zus Funktionen ab V39 --- 


-696 CreatePool (requirements,puddleSize,threshSize)(D0/D 1/D2) 
-702 DeletePool (poolHeader)(A0) 

-708 AllocPooled (poolHeader,memSize)(A0,DO) 

-714 FreePooled (poolHeader ‚memory,memSize)(A0/A 1,DO) 
j-- Misc-Funktionen -- 

-720 AttemptSemaphoreShared (sigSem)(AO) 

-726 ColdReboot (}() 

-732 StackSwap (newStack)(AO) 

;— Task-Funktionen --- 

-738 ChildFree (tid)(DO) 

-744 ChildOrphan (tid)(DO) 

-750 ChildStatus (tid)(DO) 

-756 ChildWait (tid)(DO) 

;--- Funktionen für Hardware-Erweiterungen --- 

-762 CachePreDMA (address,length,flags)(AO/A 1,DO) 

-768 CachePostDMA (address, length,flags)(A0O/A 1,DO) 

;--- LowMemoryHandler-Funktionen -- 

-774 AddMemHandler (memhand)(A1) 

-780 RemMemHandler (memhand)(A1) 
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;-- InterruptVector-Funktionen -- 

-786 ObtainQuickVector (interruptCode)(AO) 
;- interne Exec-Funktionen -- 

-792 execPrivate10 ()() 

-798 execPrivatel1 ()() 

-804 execPrivatel2 ()() 

-810 execPrivate13 (() 

-816 execPrivate14 ()() 

-822 execPrivate15 ()() 


graphics.library 


;--- primitive BitMap-Funktionen --- 
-30 BltBitMap (srcBitMap,xSrc,ySrc,destBitMap,xDest,yDest,xSize, ySize, 
minterm ‚mask ‚tempA)(A0,DO/D 1/A 1,D2/D3/D4/D5/D6/D7/A2) 
-36 BltTemplate (source,xSrc,srcMod,destRP,xDest, yDest,xSize, ySize) 
(AO,DO/D 1/A1,D2/D3/D4/D5) 
;- Text-Funktionen --- 
-42 ClearEOL (rp)(A1) 
-48 Clear$creen (rp)(Al) 
-54 TextLength (rp,string,count)(A1,A0,DO) 
-60 Text (rp,string,count)(A 1,A0,DO) 
-66 SetFont (rp,textFont)(A1,AO) 
-72 OpenFont (textAttr)(AO) 
-78 CloseFont (textFont)(A1) 
-84 AskSoftStyle (rp)(A1) 
-90 SetSoftStyle (rp,style,enable)(A1,D0/D1) 
;-- Gel-Funktionen (Bobs/Sprites) --- 
-96 AddBob (bob,rp)(AO/A1) 
-102 AddVSprite (vSprite,rp)(AO/A1) 
-108 DoCollision (rp)(A1) 
-114 DrawGlist (rp,vp)(A1,AO) 
-120 InitGels (head,tail,gelsinfo)(AO/A 1/A2) 
-126 InitMasks (vSprite)(AO) 
-132 RemiBob (bob,rp,vp)(AO/A 1/A2) 
-138 RemVSprite (vSprite)(AO) 
-144 SetCollision (num,routine,gelsinfo)(DO/AO/A1) 
-150 SortGList (rp)(A1) 
-156 AddAnimOb (anOb,anKey,rp)(AO/A 1/A2) 
-162 Animate (anKey,rp)(AO/A1) 
-168 GetGBuffers (anOb,rp,flag)(A0/A 1,DO) 
-174 InitGMasks (anOb)(AO) 
;-- Graphikgrundfunktionen --- 
-180 DrawEllipse (rp,xCenter ‚yCenter,a,b)(A1,D0/D 1/D2/D3) 
-186 AreaEllipse (rp,xCenter ‚yCenter,a,b)(A1,D0/D 1/D2/D3) 
-192 LoadRGB4 (vp,colors,count)(A0/A1,DO) 
-198 InıtRastPort (rp)(A1) 
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-204 InitVPort (vp)(AO) 

-210 MrgCop (view)(A1) 

-216 MakeVPort (view,vp)(AO/A1) 

-222 LoadView (view)(Al) 

-228 Waitßlit ()() 

-234 SetRast (rp,pen)(A1,DO) 

-240 Move (rp,x,y)J(A1,D0/D1) 

-246 Draw (rp,x,yJ)(A1,D0/D1) 

-252 AreaMove (rp,x,y)(A1,D0/D1) 

-258 AreaDraw (rp,x,y)(A1,D0/D1) 

-264 AreaEnd (rp)(A1) 

-270 WaitTOF ()() 

-276 QBlit (blit)(A1) 

-282 InitArea (arealnfo,vectorBuffer,maxVectors)(A0/A 1 ,DO) 
-288 SetRGB4 (vp,index,red,green,blue)(A0,D0/D1/D2/D3) 
-294 OBSBlit (blit)(A1) 

-300 BltClear (memBlock,byteCount,flags)(A1,D0/D1) 

-306 RectFill (rp,xMin,yMin,xMax,yMax)(A1,D0/D1/D2/D3) 
-312 BltPattern (rp,mask,xMin,yMin,xMax,yMax,maskBPR)(A 1,A0,D0/D 1/D2/D3/D4) 
-318 ReadPixel (rp,x,y)(A1,D0/D1) 

-324 WritePixel (rp,x,y)(A1,D0/D1) 

-330 Flood (rp,mode,x,y)(A1,D2,D0/D1) 

-336 PolyDraw (rp,count,polyTable)(A 1,DO/AO) 

-342 SetAPen (rp,pen)(A1,DO) 

-348 SetBPen (rp,pen)(A1,DO) 

-354 SetDrMd (rp,drawMode)(A1,DO) 

-360 InitView (view)(A1) 

-366 CBump (copList)(A1) 

-372 CMove (copList,destination,data)(A1,D0/D1) 

-378 CWait (copList,v,h)(A1,D0/D1) 

-384 VBeamPos ()() 

-390 InitBitMap (bitMap,depth, width, height)(A0,D0/D1/D2) 
-396 ScrollRaster (rp,dx,dy,xMin,yMin,xMax,yMax)(A1,DO/D 1/D2/D3/D4/D5) 
-402 WaitBOVP (vp)(AO) 

-408 GetSprite (sprite,num)(A0,DO) 

-414 FreeSprite (num)(DO) 

-420 ChangeSprite (vp,sprite,newData)(A0/A1/A2) 

-426 MoveSprite (vp,sprite,x,y)(AD/A1,D0/D1) 

-432 LockLayerRom (layer)(A5) 

-438 UnlockLayerRom (layer)(A5) 

-444 SyncSBitMap (layer)(AO) 

-450 CopySBitMap (layer)(AO) 

-456 OwnbBlitter (/() 

-462 DisownBlitter ()() 

-468 InitTmpRas (tmpRas,buffer ‚size)(AO/A 1,DO) 

-474 AskFont (rp,textAttr)(A1,AO) 

-480 AddFont (textFont)(A1) 

-486 RemFont (textFont)(A1) 
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-492 AllocRaster (width,height)(DO/D1) 

-498 FreeRaster (p,width,height)(A0,DO/D1) 

-504 AndRectRegion (region,rectangle)(A0/A1) 

-510 OrRectRegion (region,rectangle)(A0/A1) 

-516 NewRegion (}() 

-522 ClearRectRegion (region,rectangle)(AD/A1) 

-528 ClearRegion (region)(AO) 

-534 DisposeRegion (region)(A0) 

-540 FreeVPortCopLists (vp)(A0) 

-546 FreeCopList (copList)(AO) 

-552 ClipBlit (srcRP,xSrc,ySrc,destRP,xDest, yDest,xSize,ySize,minterm) 
(AO,DO/D 1/A1,D2/D3/D4/D5/D6) 

-558 XorRectRegion (region,rectangle)(A0/A1) 

-564 FreeCprList (cprList)(AO) 

-570 GetColorMap (entries)(DO) 

-576 FreeColorMap (colorMap)(AO) 

-582 GetRGB4 (colorMap,entry)(A0,DO) 

-588 ScrollVPort (vp)(AO) 

-594 UCopperlistinit (uCopList,n)(A0O,DO) 

-600 FreeGBuffers (anOb,rp,flag)(A0/A1,DO) 

-606 BltBitMapRastPort (srcBitMap,xSrc,ySrc,destRP,xDest,yDest,xSize,ySize, 

minterm)(A0,DO/D 1/A1,D2/D 3/D4/D5/D6) 

-612 OrRegionRegion (srcRegion,destRegion)(A0/A1) 

-618 XorRegionRegion (srcRegion,destRegion)(A0/A1) 

-624 AndRegionRegion (srcRegion,destRegion)(A0/A1) 

-630 SetRGB4CM (colorMap,index,red,green,blue)(A0,DO/D 1/D2/D3) 

-636 BltMaskBitMapRastPort (srcBitMap,xSrc,ySrc,destRP,xDest,yDest,xSize, 

ySize,minterm,bltMask)(A0,DO/D 1/A 1,D2/D3/D4/D5/ 
D6/A2) 

;-- 2 interne Grafikfunktionen --- 

-642 graphicsPrivate1 ()() 

-648 graphicsPrivate2 ()() 

-654 AttemptlLockLayerRom (layer)(A5) 

;--- Funktionen ab V36 (052.0) -- 

-660 GfxNew (gfxNodeType)(DO) 

-666 GfxFree (gfxNodePtr)(AO) 

-672 GfxAssociate (associateNode,gfxNodePtr)(AO/A1) 

-678 BitMapScale (bitScaleArgs)(AO) 

-684 ScalerDiv (factor,numerator,denominator)(DO/D 1/D2) 

-690 TextExtent (rp,string,count,textExtent)(A 1,A0,DO/A2) 

-696 TextFit (rp,string,strLen,textExtent,constrainingExtent, 
strDirection,constrainingBitWidth,constrainingBitHeight) 
(A1,AO0,DO/A2/A3,D1/D2/D3) 

-702 GfxLookUp (associateNode)(AO) 

-708 VideoControl (colorMap,tagarray)(A0/A 1) 

-714 OpenMonitor (monitor Name,displayID)(A1,DO) 
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-720 CloseMonitor (monitorSpec)(A0) 

-726 FindDisplayInfo (displayID)(DO) 

-732 NextDisplayInfo (displayID)(DO) 

;— 3 interne Grafikfunktionen --- 

-738 graphicsPrivate3 ()() 

-744 graphicsPrivate4 ()() 

-750 graphicsPrivate5 ()() 

-756 GetDisplayInfoData (handle,buf,size,tagID,displayID)(AO/A1,D0/D1/D2) 

-762 FontExtent (font,fontExtent)(A0/A1) 

-768 ReadPixellineß (rp,xstart,ystart,width,array,tempRP)(AO,DO/D 1/D2/A2,A1) 

-774 \WritePixelLine8 (rp,xstart,ystart,width,array,tempRP)(A0,DO/D1/D2/A2,A1) 

-780 ReadPixelArray8 (rp,xstart,ystart,xstop,ystop,array,temprp) 
(AO,DO/D 1/D2/D3/A2,A1) 

-786 WritePixelArray8 (rp,xstart,ystart,xstop,ystop,array,temprp) 
(AO,DO/D 1/D2/D3/A2,A1) 

-792 GetVPModelD (vp)(AO) 

-798 ModeNotAvailable (modelD)(DO) 

-804 WeighTAMatch (reqTextAttr,targetTextAttr,targetTags)(AO/A1/A2) 

-810 EraseRect (rp,xMin,yMin,xMax,yMax)(A1,D0/D1/D2/D3) 

-816 ExtendFont (font,fontTags)(A0/A1) 

-822 StripFont (font)(AO) 


;== Funktionen ab V39 (053.0) -- 


-828 CalcIVG (v,vp)(AO/A1) 

-834 AttachPalExtra (cm,vp)(AO/A1) 

-840 ObtainBestPenA (cm,r,g,b,tags)(A0,D1/D2/D3/A1) 
;- 1 interne Grafikfunktionen --- 

-846 graphicsPrivate6 ()() 

-852 SetRGB32 (vp,n,r,g,b)(A0,DO/D 1/D2/D3) 

-858 GetAPen (rp)(AO) 

-864 GetBPen (rp)(A0O) 

-870 GetDrMd (rp)(AO) 

-876 GetOutlinePen (rp)(AO) 

-882 LoadRGB32 (vp,table)(A0/A1) 

-888 SetChipRev (want)(DO) 

-894 SetABPenDrMd (rp,apen,bpen,drawmode)(A1,D0/D1/D2) 
-900 GetRGB32 (cm ,firstcolor ,ncolors,table)(A0O,DO/D1/A1) 
;— 2 interne Grafikfunktionen --- 

-906 graphicsPrivate? ()() 

-912 graphicsPrivate8 ()() 

-918 AllocBitMap (sizex,sizey,depth,flags,friend_bitmap)(DO/D 1/D2/D3/AO) 
-924 FreeBitMap (bm)(A0) 

-930 GetExtSpriteA (ss,tags)(A2,A1) 

-936 CoerceMode (vp,monitorid,flags)(A0O,DO/D1) 

-942 ChangeVPBitMap (vp,bm,db)(A0/A 1/A2) 

-948 ReleasePen (cm,n)(A0,DO) 

-954 ObtainPen (cm,n‚r,g,b,f)(AO,DO/D 1/D2/D3/D4) 


Seite 583 


Anhang 


-960 GetBitMapAttr (bm,attrnum)(A0,D1) 

-966 AllocDBuflinfo (vp)(A0) 

-972 FreeDBuflnfo (dbi)(A1) 

-978 SetOutlinePen (rp,pen)(A0,DO) 

-984 Set\WriteMask (rp,msk)(A0,DO) 

-990 SetMaxPen (rp,maxpen)(A0,DO) 

-996 SetRGB32CM (cm,n‚r,g.b)(A0,DO/D 1/D2/D3) 

-1002 ScrollRasterBF (rp,dx,dy,xMin,yMin,xMax,yMax)(A 1,DO/D 1/D2/D3/D4/D5) 
-1008 FindColor (cm,r,g,b,maxcolor)(A3,D1/D2/D3/D4) 

;--- 1 interne Grafikfunktion --- 

-1014 graphicsPrivate9 ()() 

-1020 AllocSpriteDataA (bm,tags)(A2,A1) 

-1026 ChangeExtSpriteA (vp ‚oldsprite,newsprite,tags)(AO/A 1/A2/A3) 
-1032 FreeSpriteData (sp)(A2) 

-1038 SetRPAttrsA (rp,tags)(A0/A1) 

-1044 GetRPAttrsA (rp,tags)(AO/A1) 

-1050 BestModelDA (tags)(A0) 


zus Funktionen ab V40 (053.1) -—- 
-1054 WriteChunkyPixels (rp,xstart, ystart,xstop, ystop,array,bytesperrow) 
(AO,DO/D 1/D2/D 3/A2,D4) 


intuition.library 


-30 Open!intuition ()() 

-36 Intuition (iEvent)(AO) 

-42 AddGadget (window,gadget,position)(A0O/A1,DO) 

-48 ClearDMRequest (window)(AO) 

-54 ClearMenuStrip (window)(AO) 

-60 ClearPointer (window)(AO) 

-66 CloseScreen (screen)(AO) 

-72 CloseWindow (window)(A0) 

-78 CloseWorkBench ()() 

-84 CurrentTime (seconds,micros)(AO/A1) 

-90 DisplayAlert (alertNumber string, height)(DO/AO,D1) 

-96 DisplayBeep (screen)(AO) 

-102 DoubleClick (sSeconds,sMicros,cSeconds,cMicros)(DO/D 1/D2/D3) 
-108 DrawBorder (rp,border ‚leftOffset,topOffset)(AO/A 1,D0/D 1) 
-114 Drawlmage (rp,image,‚leftOffset,topOffset)(AO/A1,D0/D 1) 
-120 EndRequest (requester,window)(AO/A1) 

-126 GetDefPrefs (preferences,size)(A0O,DO) 

-132 GetPrefs (preferences,size)(A0,DO) 

-138 InitRequester (requester)(AO) 

-144 ItemAddress (menuStrip,menuNumber)(A0,DO) 

-150 ModifyIDCMP (window, flags)(A0,DO) 
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-156 ModifyProp (gadget,window,requester,flags,horizPot,vertPot,horizBody, 
vertBody)(A0/A 1/A2,DO/D 1/D2/D3/D4) 
-162 MoveScreen (screen,dx,dy)(A0,DO/D1) 
-168 MoveWindow (window ‚dx,dy)(A0O,DO/D1) 
-174 OffGadget (gadget,window,requester)(A0/A 1/A2) 
-180 OffMenu (window,menuNumber)(A0,DO) 
-186 OnGadget (gadget,window,requester)(A0/A 1/A2) 
-192 OnMenu (window,menuNumber)(A0,DO) 
-198 OpenScreen (newScreen)(A0) 
-204 OpenWindow (newWindow)(AO) 
-210 OpenWorkBench (\}() 
-216 PrintlText (rp,iText,left,top)(A0/A1,D0/D1) 
-222 RefreshGadgets (gadgets,window,requester)(AO/A1/A2) 
-228 RemoveGadget (window, gadget)(AO/A1) 
-234 ReportMouse (flag,window)(DO/AO) 
-240 Request (requester,window)(AO/A1) 
-246 ScreenToBack (screen)(AO) 
-252 ScreenTofFront (screen)(AO) 
-258 SetDMRequest (window ‚requester){AO/A 1) 
-264 SetMenuStrip (window,menu)(A0/A1) 
-270 SetPointer (window,pointer,height,width,xOffset, yOffset) 
(AO/A1,D0/D 1/D2/D3) 
-276 SetWindowfTitles (window,windowfTitle,screenTitle)(AO/A 1/A2) 
-282 ShowfTitle (screen ‚showlIt)(AO,DO) 
-288 SizeWindow (window,dx,dy)(A0,DO/D1) 
-294 ViewAddress ()() 
-300 ViewPortAddress (window)(AO) 
-306 WindowToBack (window)(AO) 
-312 WindowToFront (window)(AO) 
-318 WindowLimits (window, widthMin,heightMin,widthMax,heightMax) 
(AO,D0/D1/D2/D3) 
-324 SetPrefs (preferences,size,inform)(A0,DO/D1) 
-330 IntuiTextLength (iText)(AO) 
-336 WBenchToBack ()() 
-342 WBenchTofront ()() 
-348 AutoRequest (window,body,posText,negText,pFlag,nFlag,width,height) 
(AO/A1/A2/A3,DO/D1/D2/D3) 
-354 BeginRefresh (window)(A0) 
-360 BuildSysRequest (window,body,posText,negText,flags,width,height) 
(AO/A 1/A2/A3,DO/D1/D2) 
-366 EndRefresh (window,complete)(A0,DO) 
-372 FreeSysRequest (window)(AO) 
-378 Make$creen (screen)(A0) 
-384 RemakeDisplay ()() 
-390 RethinkDisplay ()() 
-396 AllocRemember (rememberkey,‚size,flags)(A0O,DO/D1) 
-402 AlohaWorkbench (wbport)(AO) 
-408 FreeRemember (rememberkey,reallyForget)(A0,DO) 
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-414 LocklBase (dontknow)(DO) 
-420 UnlocklIBase (ibLock)(AO) 


;-- Funktionen ab V33 (051.2) -- 


-426 GetScreenData (buffer ‚size,type,screen)(A0,DO/D1/A1) 

-432 RefreshGList (gadgets,window,requester,numGad)(AO/A1/A2,DO) 

-438 AddGlist (window, gadget,position,numGad,requester)(AO/A 1,D0/D1/A2) 

-444 RemoveGlist (remPtr,gadget,numGad)(AO/A 1,DO) 

-450 ActivateWindow (window)(AO) 

-456 RefreshWindowFrame (window)(AO) 

-462 ActivateGadget (gadgets,window,requester)(A0/A1/A2) 

-468 NewModifyProp (gadget,window,requester,flags,horizPot,vertPot,horizBody, 
vertBody,numGad)(AO/A 1/A2,DO0/D1/D2/D 3/D4/D5) 


‚= Funktionen ab V36 (052.0) —- 


-474 QueryOverscan (displayID,rect,oScanType)(A0/A1,DO) 

-480 MoveWindowInFrontOf (window,behindWindow)(A0/A1) 

-486 ChangeWindowBox (window,left,top,width,height)(A0,DO/D1/D2/D3) 

-492 SetEditHook (hook)(AO) 

-498 SetMouseQueue (window,queueLength)(A0,DO) 

-504 ZipWindow (window)(AO) 

-510 LockPubScreen (name)(AO) 

-516 UnlockPubScreen (name,screen)(A0/A1) 

-522 LockPub$creenlist ()() 

-528 UnlockPub$creenlist ()() 

-534 NextPubScreen (screen,namebuf)(A0/A1) 

-540 SetDefaultPubScreen (name)(AO) 

-546 SetPubScreenModes (modes)(DO) 

-552 PubScreenStatus (screen,statusFlags)(A0,DO) 

-558 ObtainGIRPort (gInfo)(AO) 

-564 ReleaseGIRPort (rp)(AO) 

-570 GadgetMouse (gadget,gInfo,mousePoint)(AO/A 1/A2) 

;- 1 interne Intuition-Funktion --- 

-576 intuitionPrivate1 ()() 

-582 GetDefaultPubScreen (nameBuffer)(AO) 

-588 EasyRequestArgs (window easyStruct,idempPtr ,args)(AO/A 1/A2/A3) 

-594 BuildEasyRequestArgs (window, easyStruct,idemp,args)(A0O/A 1,D0/A3) 

-600 SysReqHandler (window, idempPtr ‚waitinput)(AO/A 1,DO) 

-606 OpenWindowTagList (newWindow ‚tagList)(AO/A 1) 

-612 OpenScreenTagList (newScreen,tagList)(AO/A1) 

-618 DrawlmageState (rp,image,leftOffset,topOffset,state,draw Info) 
(AO/A 1,D0/D 1/D2/A2) 

-624 PointInimage (point,image)(DO/AO) 

-630 Eraselmage (rp,image,leftOffset,topOffset)(A0O/A1,D0/D1) 

-636 NewObjectA (classPtr,classID,tagList)(AO/A 1/A2) 

-642 DisposeObject (object)(AO) 


Seite 586 


Anhang nein 


-648 SetAttrsA (object,tagList)(AO/A1) 

-654 GetAttr (attrID,object,storagePtr)(DO/AO/A]) 

-660 SetGadgetAttrsA (gadget,window,requester,tagList\(AO/A1/A2/A3) 

-666 NextObject (objectPtrPtr)(AO) 

;- 1 interne Intuition-Funktion --- 

-672 intuitionPrivate2 ()() 

-678 MakeClass (classID,superClassID,superClassPtr,instanceSize,flags) 
(AO/A1/A2,DO/D1) 

-684 AddClass (classPtr)(AO) 

-690 GetScreenDrawinfo (screen)(AO) 

-696 FreeScreenDrawinfo (screen,drawInfo)(AO/A1) 

-702 ResetMenuStrip (window,menu)(AO/A1) 

-708 RemovecClass (classPtr)(AO) 

-714 FreeClass (classPtr)(AO) 

;- 2 interne Intuition-Funktionen --- 

-720 intuitionPrivate3 ()() 

-726 intuitionPrivate4 ()() 

;-- 6 reservierte Vektoren --- 

-732 intuitionReserveD1 ()() 

-738 intuitionReserveD2 ()() 

-744 intuitionReserveD3 (}() 

-750 intuitionReserveD4 ()() 

-756 intuitionReserveD5 ()() 

-762 intuitionReserveD6 ()() 


‚== Funktionen ab V39 (053.0) -- 


-768 Alloc$creenBuffer (sc,bm,flags)(A0/A1,DO) 

-774 FreeScreenBuffer (sc,sb)(A0/A1) 

-780 ChangeScreenBuffer (sc,sb)(AO/A1) 

-786 ScreenDepth (screen ‚flags,reserved)(A0O,DO/A1) 

-792 ScreenPosition (screen, flags,x1,y1,x2,y2)(A0,DO/D 1/D2/D3/D4) 
-798 ScrollWindowRaster (win,dx,dy,xMin,yMin,xMax,yMax)(A1,DO/D 1/D2/D3/D4/D5) 
-804 LendMenus (fromwindow,towindow)(AO/A1) 

-810 DoGadgetMethodA (gad,win,req,message)(A0/A1/A2/A3) 

-816 SetWindowPointerA (win,taglist)(AD/A1) 

-822 TimedDisplayAlert (alertNumber,‚string,height,time)(DO/AO,D1/A1) 
-828 HelpControl (win, flags)(AO,DO) 
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gadtools.library 


‚== Funktionen ab V36 (052.0) -- 


-30 CreateGadgetA (kind,gad,ng,taglist)(DO/AO/A 1/A2) 
-36 FreeGadgets (gad)(A0) 
-42 GT_SetGadgetAttrsA (gad,win,req,taglist)(AO/A 1/A2/A3) 
-48 CreateMenusA (newmenu,taglist)(AO/A1) 
-54 FreeMenus (menu)(AO) 
-60 LayoutMenultemsA (firstitem,vi,taglist)(AO/A 1/A2) 
-66 LayoutMenusA (firstmenu,vi,taglist)(AO/A 1/A2) 
-72 GT_GetlMsg (iport)(AO) 
-78 GT_ReplyIMsg (imsg)(A1) 
-84 GT_RefreshWindow (win,rea)(A0/A1) 
-90 GT _BeginRefresh (win)(AO) 
-96 GT_EndRefresh (win,complete)(A0,DO) 
-102 GT _FilterIMsg (imsg)(A1) 
-108 GT_PostfilterIMsg (imsg)(A1) 
-114 CreateContext (glistptr)(AO) 
-120 DrawBevelBoxA (rport, left,top,width,height,taglist)(AO,D0/D1/D2/D3/A1) 
-126 GetVisuallnfoA (screen,taglist)(AO/A1) 
-132 FreeVisuallnfo (vi)(AO) 
;--- 6 interne Gadget-Funktionen -- 
-138 gadtoolsPrivate1 ()() 
-144 gadtoolsPrivate2 ()() 
-150 gadtoolsPrivate3 ()() 
-156 gadtoolsPrivate4 ()() 
-162 gadtoolsPrivate5 ()() 
-168 gadtoolsPrivate6 ()() 


je Funktionen ab V39 (053.0) - 
-174 GT_GetGadgetAttrsA (gad,win,req,taglist)(AO/A1/A2/A3) 


lowlevel.library (externe Library) 


;-- Funktionen ab V40 (053.1) - 


-30 ReadJoyPort (port)(DO) 

-36 GetlanguageSelection ()() 

;- 1 interne LowLevel-Funktion --- 

-42 lowlevelPrivate1 ()() 

-48 GetKey ()() 

-54 QueryKeys (queryArray,arraySize)(A0,D]1) 
-60 AddkKBint (intRoutine,intData)(A0/A 1) 
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-66 RemkBint (intHandle)(A1) 
+72 SystemControlA (tagList)(A1) 

-78 AddTimerlnt (intRoutine,intData)(AO/A1) 

-84 RemTimerlnt (intHandle)(A1) 

-90 StopTimerlnt (intHandle)(A1) 

-96 StartTimerlnt (intHandle,timelnterval,continuous)(A1,DO/D1) 
-102 ElapsedTime (context)(AO) 

-108 AddVBlanklnt (intRoutine,intData)(A0/A1) 
-114 RemVBlanklnt (intHandle)(A1) 

;- 2 interne LowLevel-Funktionen -- 

-120 lowlevelPrivate2 ()() 

-126 lowlevelPrivate3 ()() 

-132 SetJoyPortAttrsA (portNumber,tagList)(DO/A1) 
;-- 5 interne LowLevel-Funktionen -- 

-138 lowlevelPrivate4()() 

-144 lowlevelPrivate5()() 

-150 lowlevelPrivate6()() 

-156 lowlevelPrivate?7()() 

-162 lowlevelPrivate8()() 
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Stichwortverzeichnis 


AA-Chipset 
AAA-Chipset 
ADKCON 
Adressierung 
Agnus 

Alice 

Amiga 
Amigaaufbau 
Animation 
Attached-Sprite 
ATC 

AttnFlags 
Attribute 
Aufzeichnungsverfahren 


Bildschirm 
Bitmap 

Blitter 
Blittervorgang 
Block 

Blöcke 
Bootblock 
Bootprogramm 
Bussignale 


Cache 

Cs 

CIA (8520) 
Codieren 
CoolCapture 
ColdCapture 
Copper 
Copperbefehle 
Copperinterrupt 


66,562 
67 
215,241,551 
139 
69 

76 

1 

2 

538 
458 
183 
126 
498 
216 


401 
407 
430 
441 
222 
222 
271 
273 
8,17 


25,138 
106 


218 
>14 
>14 
392 
393 
398 


Copperliste 
Co-Prozessoren 
Custom-Chips 


Data-Block 
Datenbits 
Datenblock 
Decodieren 
Denise 
Descriptor 
Device 
Diskregister 
DMA-Kanäle 
DMACON 
DOS-Library 
Double-Buffering 
Dualplayfield 


Exception 
Exec 

Execbase 
Extra-HalfBrite 


Farben 
Fileverwaltung 
Fließkommazahlen 
FMode 

FPU 


Gale 
HAM 
Handler 
Hunk 


IFF-Standard 


496 


467 
421 


408 
270 
147 
569 
42,146 


80 
420,564 
509 

363 


32 


Info-Blocks 

Info-Struktur 

Interlace 
Interrupteingänge (IPLx) 
Interrupts 


Joystick 


Kollision 
Kopierprogramm 


Lautstärke 
LibraryBase 
Linien 

Lisa 
ListHead 
ListNode 


Maus 
MC68000 
MC68020 
MC68030 
MC68040 
MC68060 
M(C68881/2 
MessagePort 
Message-System 
MMU 

Modul 


Packvorgang 
Parallel 
Paula 
Playfields 
Priorität 
Productivity 


223 

280 

419 
10,18 
129,508 


546 


461 
268 


549 
476 
444 
78 

470 
469 


Register 
Registersatz 
Reset 
Resident 


Scrolling 
Seriell 
Server 
Sprites 
Status-Flag 
Sync 


Taktbits 

Timer 

TLB 

Ton 

Tonhöhe 
Transparent-Translation (TTx) 


VBR 


Wellenform 


118 
6,14,22,28,37 
513 
480 
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Grundlagen zu: 


AMIGA-DOS 
Prozessoren 
Multitasking 
AMIGA Intern 
Hardware 
Software 

Der Blıtter 
Sprites 
IFF-Standard 





Autor: J. Schimanski 


Dieses sehr umfangreiche Buchwerk soll dem 
ambitionierten Anwender, Freak und lesebegeister- 
ten Hobby-Techniker den Durchblick in Sachen 
AMIGA Hardware vermitteln. Die Grundlagen wer- 
den mit Diagrammen, Strichzeichnungen und Bil- 
dern ausführlich besprochen und erklärt. 


Aus dem Inhalt: 

Hardwaregrundlagen: Die verschiedenen Prozesso- 
ren und Chips - Alle Schnittstellen - Das AMIGA 
Diskettenformat - Fileverwaltung - Der Co-Prozes- 
sor - AMIGA DOS - ASL-Library - Playfields - Der 
Blitter - Sprites - Das Multitasking-System - Die 
Low Level Library - Animationen - Ein-/Ausgabe- 
geräte - Tonerzeugung - IFF-Standard - AA-Hard- 
ware - Tips & Tricks zu Hard- und Software uvm. 


Lieferung: 
Inklusive Diskette mit Programmiertoo!. 


Systemvoraussetzung: 
AMIGA mit mind. 1 MB RAM und Kickstart ab 2.0. 


Art.-Nr. 2775 
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